public abstract interface AppletContext

This interface corresponds to an applet's environment: the document containing the applet and the other applets in the same document.

The methods in this interface can be used by an applet to obtain information about its environment.

public Applet getApplet(String)

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 name attribute.

String name: an applet name.

public Enumeration getApplets()

Finds all the applets in the document represented by this applet context.

public AudioClip getAudioClip(URL)

Creates an audio clip.

URL url: an absolute URL giving the location of the audio clip.

public Image getImage(URL)

Returns an Image object that can then be painted on the screen. The url argument that is passed as an argument must specify an absolute URL.

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.

URL url: an absolute URL giving the location of the image.

public InputStream getStream(String)

Returns the stream to which specified key is associated within this applet context. Returns null if the applet context contains no stream for this key.

For security reasons, mapping of streams and keys exists for each codebase. In other words, applet from one codebase cannot access the streams created by an applet from a different codebase

String key: key whose associated stream is to be returned.

public Iterator getStreamKeys()

Finds all the keys of the streams in this applet context.

For security reasons, mapping of streams and keys exists for each codebase. In other words, applet from one codebase cannot access the streams created by an applet from a different codebase

public void setStream(String, InputStream)

Associates the specified stream with the specified key in this applet context. If the applet context previously contained a mapping for this key, the old value is replaced.

For security reasons, mapping of streams and keys exists for each codebase. In other words, applet from one codebase cannot access the streams created by an applet from a different codebase

String key: key with which the specified value is to be associated.

InputStream stream: stream to be associated with the specified key. If this parameter is null, the specified key is removed in this applet context.

IOException: if the stream size exceeds a certain size limit. Size limit is decided by the implementor of this interface.

public void showDocument(URL)

Requests that the browser or applet viewer show the Web page indicated by the url argument. The browser or applet viewer determines which window or frame to display the Web page. This method may be ignored by applet contexts that are not browsers.

URL url: an absolute URL giving the location of the document.

public void showDocument(URL, String)

Requests that the browser or applet viewer show the Web page indicated by the url argument. The target argument indicates in which HTML frame the document is to be displayed. The target argument is interpreted as follows:

An applet viewer or browser is free to ignore showDocument.

URL url: an absolute URL giving the location of the document.

String target: a String indicating where to display the page.

public void showStatus(String)

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.

String status: a string to display in the status window.