<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!--NewPage-->
<html>
<head>
<!-- Generated by javadoc on Wed Jul 28 01:21:15 GMT 1999 -->
<title>
  Interface java.applet.AppletContext
</title>
</head>
<body>
<a name="_top_"></a>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.applet.html">This Package</a>  <a href="Package-java.applet.html">Previous</a>  <a href="java.applet.AppletStub.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
<hr>
<h1>
  Interface java.applet.AppletContext
</h1>
<dl>
  <dt> public interface <b>AppletContext</b>
</dl>
This interface corresponds to an applet's environment: the 
 document containing the applet and the other applets in the same 
 document. 
 <p>
 The methods in this interface can be used by an applet to obtain 
 information about its environment.
<p>
<hr>
<a name="index"></a>
<h2>
  <img src="images/method-index.gif" width=207 height=38 alt="Method Index">
</h2>
<dl>
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getApplet(java.lang.String)"><b>getApplet</b></a>(String)
  <dd>  Finds and returns the applet in the document represented by this 
 applet context with the given name.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getApplets()"><b>getApplets</b></a>()
  <dd>  Finds all the applets in the document represented by this applet 
 context.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getAudioClip(java.net.URL)"><b>getAudioClip</b></a>(URL)
  <dd>  Creates an audio clip.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getImage(java.net.URL)"><b>getImage</b></a>(URL)
  <dd>  Returns an <code>Image</code> object that can then be painted on 
 the screen.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#showDocument(java.net.URL)"><b>showDocument</b></a>(URL)
  <dd>  Replaces the Web page currently being viewed with the given URL.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#showDocument(java.net.URL, java.lang.String)"><b>showDocument</b></a>(URL, String)
  <dd>  Requests that the browser or applet viewer show the Web page 
 indicated by the <code>url</code> argument.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#showStatus(java.lang.String)"><b>showStatus</b></a>(String)
  <dd>  Requests that the argument string be displayed in the 
 "status window".
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="getAudioClip(java.net.URL)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getAudioClip"><b>getAudioClip</b></a>
<pre>
 public abstract <a href="java.applet.AudioClip.html#_top_">AudioClip</a> getAudioClip(<a href="java.net.URL.html#_top_">URL</a> url)
</pre>
<dl>
  <dd> Creates an audio clip.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> url - an absolute URL giving the location of the audio clip.
    <dt> <b>Returns:</b>
    <dd> the audio clip at the specified URL.
  </dl></dd>
</dl>
<a name="getImage(java.net.URL)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getImage"><b>getImage</b></a>
<pre>
 public abstract <a href="java.awt.Image.html#_top_">Image</a> getImage(<a href="java.net.URL.html#_top_">URL</a> url)
</pre>
<dl>
  <dd> Returns an <code>Image</code> object that can then be painted on 
 the screen. The <code>url</code> argument<code> </code>that is 
 passed as an argument must specify an absolute URL. 
 <p>
 This method always returns immediately, whether or not the image 
 exists. When the applet attempts to draw the image on the screen, 
 the data will be loaded. The graphics primitives that draw the 
 image will incrementally paint on the screen.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> url - an absolute URL giving the location of the image.
    <dt> <b>Returns:</b>
    <dd> the image at the specified URL.
    <dt> <b>See Also:</b>
    <dd> <a href="java.awt.Image.html#_top_">Image</a>
  </dl></dd>
</dl>
<a name="getApplet(java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getApplet"><b>getApplet</b></a>
<pre>
 public abstract <a href="java.applet.Applet.html#_top_">Applet</a> getApplet(<a href="java.lang.String.html#_top_">String</a> name)
</pre>
<dl>
  <dd> Finds and returns the applet in the document represented by this 
 applet context with the given name. The name can be set in the 
 HTML tag by setting the <code>name</code> attribute.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> name - an applet name.
    <dt> <b>Returns:</b>
    <dd> the applet with the given name, or <code>null</code> if
          not found.
  </dl></dd>
</dl>
<a name="getApplets()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getApplets"><b>getApplets</b></a>
<pre>
 public abstract <a href="java.util.Enumeration.html#_top_">Enumeration</a> getApplets()
</pre>
<dl>
  <dd> Finds all the applets in the document represented by this applet 
 context.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> an enumeration of all applets in the document represented by
          this applet context.
  </dl></dd>
</dl>
<a name="showDocument(java.net.URL)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="showDocument"><b>showDocument</b></a>
<pre>
 public abstract void showDocument(<a href="java.net.URL.html#_top_">URL</a> url)
</pre>
<dl>
  <dd> Replaces the Web page currently being viewed with the given URL. 
 This method may be ignored by applet contexts that are not 
 browsers.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> url - an absolute URL giving the location of the document.
  </dl></dd>
</dl>
<a name="showDocument(java.net.URL, java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="showDocument"><b>showDocument</b></a>
<pre>
 public abstract void showDocument(<a href="java.net.URL.html#_top_">URL</a> url,
                                   <a href="java.lang.String.html#_top_">String</a> target)
</pre>
<dl>
  <dd> Requests that the browser or applet viewer show the Web page 
 indicated by the <code>url</code> argument. The 
 <code>target</code> argument indicates in which HTML frame the 
 document is to be displayed. 
 The target argument is interpreted as follows:
 <p>
 <center><table border="3"> 
 <tr><td><code>"_self"</code>  <td>Show in the window and frame that 
                                   contain the applet.</tr>
 <tr><td><code>"_parent"</code><td>Show in the applet's parent frame. If 
                                   the applet's frame has no parent frame, 
                                   acts the same as "_self".</tr>
 <tr><td><code>"_top"</code>   <td>Show in the top-level frame of the applet's 
                                   window. If the applet's frame is the 
                                   top-level frame, acts the same as "_self".</tr>
 <tr><td><code>"_blank"</code> <td>Show in a new, unnamed
                                   top-level window.</tr>
 <tr><td><i>name</i><td>Show in the frame or window named <i>name</i>. If 
                        a target named <i>name</i> does not already exist, a 
                        new top-level window with the specified name is created, 
                        and the document is shown there.</tr>
 </table> </center>
 <p>
 An applet viewer or browser is free to ignore <code>showDocument</code>.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> url - an absolute URL giving the location of the document.
    <dd> target - a <code>String</code> indicating where to display
                   the page.
  </dl></dd>
</dl>
<a name="showStatus(java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="showStatus"><b>showStatus</b></a>
<pre>
 public abstract void showStatus(<a href="java.lang.String.html#_top_">String</a> status)
</pre>
<dl>
  <dd> Requests that the argument string be displayed in the 
 "status window". Many browsers and applet viewers 
 provide such a window, where the application can inform users of 
 its current state.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> status - a string to display in the status window.
  </dl></dd>
</dl>
<hr>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.applet.html">This Package</a>  <a href="Package-java.applet.html">Previous</a>  <a href="java.applet.AppletStub.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>
