java.applet
Interface AppletContext


public 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.

Since:
JDK1.0

Method Summary
 Applet sample code for java.applet.Applet definition code for java.applet.Applet getApplet sample code for java.applet.AppletContext.getApplet(java.lang.String) definition code for java.applet.AppletContext.getApplet(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  name)
          Finds and returns the applet in the document represented by this applet context with the given name.
 Enumeration sample code for java.util.Enumeration definition code for java.util.Enumeration <Applet sample code for java.applet.Applet definition code for java.applet.Applet > getApplets sample code for java.applet.AppletContext.getApplets() definition code for java.applet.AppletContext.getApplets() ()
          Finds all the applets in the document represented by this applet context.
 AudioClip sample code for java.applet.AudioClip definition code for java.applet.AudioClip getAudioClip sample code for java.applet.AppletContext.getAudioClip(java.net.URL) definition code for java.applet.AppletContext.getAudioClip(java.net.URL) (URL sample code for java.net.URL definition code for java.net.URL  url)
          Creates an audio clip.
 Image sample code for java.awt.Image definition code for java.awt.Image getImage sample code for java.applet.AppletContext.getImage(java.net.URL) definition code for java.applet.AppletContext.getImage(java.net.URL) (URL sample code for java.net.URL definition code for java.net.URL  url)
          Returns an Image object that can then be painted on the screen.
 InputStream sample code for java.io.InputStream definition code for java.io.InputStream getStream sample code for java.applet.AppletContext.getStream(java.lang.String) definition code for java.applet.AppletContext.getStream(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  key)
          Returns the stream to which specified key is associated within this applet context.
 Iterator sample code for java.util.Iterator definition code for java.util.Iterator <String sample code for java.lang.String definition code for java.lang.String > getStreamKeys sample code for java.applet.AppletContext.getStreamKeys() definition code for java.applet.AppletContext.getStreamKeys() ()
          Finds all the keys of the streams in this applet context.
 void setStream sample code for java.applet.AppletContext.setStream(java.lang.String, java.io.InputStream) definition code for java.applet.AppletContext.setStream(java.lang.String, java.io.InputStream) (String sample code for java.lang.String definition code for java.lang.String  key, InputStream sample code for java.io.InputStream definition code for java.io.InputStream  stream)
          Associates the specified stream with the specified key in this applet context.
 void showDocument sample code for java.applet.AppletContext.showDocument(java.net.URL) definition code for java.applet.AppletContext.showDocument(java.net.URL) (URL sample code for java.net.URL definition code for java.net.URL  url)
          Replaces the Web page currently being viewed with the given URL.
 void showDocument sample code for java.applet.AppletContext.showDocument(java.net.URL, java.lang.String) definition code for java.applet.AppletContext.showDocument(java.net.URL, java.lang.String) (URL sample code for java.net.URL definition code for java.net.URL  url, String sample code for java.lang.String definition code for java.lang.String  target)
          Requests that the browser or applet viewer show the Web page indicated by the url argument.
 void showStatus sample code for java.applet.AppletContext.showStatus(java.lang.String) definition code for java.applet.AppletContext.showStatus(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  status)
          Requests that the argument string be displayed in the "status window".
 

Method Detail

getAudioClip sample code for java.applet.AppletContext.getAudioClip(java.net.URL) definition code for java.applet.AppletContext.getAudioClip(java.net.URL)

AudioClip sample code for java.applet.AudioClip definition code for java.applet.AudioClip  getAudioClip(URL sample code for java.net.URL definition code for java.net.URL  url)
Creates an audio clip.

Parameters:
url - an absolute URL giving the location of the audio clip.
Returns:
the audio clip at the specified URL.

getImage sample code for java.applet.AppletContext.getImage(java.net.URL) definition code for java.applet.AppletContext.getImage(java.net.URL)

Image sample code for java.awt.Image definition code for java.awt.Image  getImage(URL sample code for java.net.URL definition code for java.net.URL  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.

Parameters:
url - an absolute URL giving the location of the image.
Returns:
the image at the specified URL.
See Also:
Image sample code for java.awt.Image definition code for java.awt.Image

getApplet sample code for java.applet.AppletContext.getApplet(java.lang.String) definition code for java.applet.AppletContext.getApplet(java.lang.String)

Applet sample code for java.applet.Applet definition code for java.applet.Applet  getApplet(String sample code for java.lang.String definition code for java.lang.String  name)
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.

Parameters:
name - an applet name.
Returns:
the applet with the given name, or null if not found.

getApplets sample code for java.applet.AppletContext.getApplets() definition code for java.applet.AppletContext.getApplets()

Enumeration sample code for java.util.Enumeration definition code for java.util.Enumeration <Applet sample code for java.applet.Applet definition code for java.applet.Applet > getApplets()
Finds all the applets in the document represented by this applet context.

Returns:
an enumeration of all applets in the document represented by this applet context.

showDocument sample code for java.applet.AppletContext.showDocument(java.net.URL) definition code for java.applet.AppletContext.showDocument(java.net.URL)

void showDocument(URL sample code for java.net.URL definition code for java.net.URL  url)
Replaces the Web page currently being viewed with the given URL. This method may be ignored by applet contexts that are not browsers.

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

showDocument sample code for java.applet.AppletContext.showDocument(java.net.URL, java.lang.String) definition code for java.applet.AppletContext.showDocument(java.net.URL, java.lang.String)

void showDocument(URL sample code for java.net.URL definition code for java.net.URL  url,
                  String sample code for java.lang.String definition code for java.lang.String  target)
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:

Target ArgumentDescription
"_self" Show in the window and frame that contain the applet.
"_parent"Show in the applet's parent frame. If the applet's frame has no parent frame, acts the same as "_self".
"_top" 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".
"_blank" Show in a new, unnamed top-level window.
nameShow in the frame or window named name. If a target named name does not already exist, a new top-level window with the specified name is created, and the document is shown there.

An applet viewer or browser is free to ignore showDocument.

Parameters:
url - an absolute URL giving the location of the document.
target - a String indicating where to display the page.

showStatus sample code for java.applet.AppletContext.showStatus(java.lang.String) definition code for java.applet.AppletContext.showStatus(java.lang.String)

void showStatus(String sample code for java.lang.String definition code for java.lang.String  status)
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.

Parameters:
status - a string to display in the status window.

setStream sample code for java.applet.AppletContext.setStream(java.lang.String, java.io.InputStream) definition code for java.applet.AppletContext.setStream(java.lang.String, java.io.InputStream)

void setStream(String sample code for java.lang.String definition code for java.lang.String  key,
               InputStream sample code for java.io.InputStream definition code for java.io.InputStream  stream)
               throws IOException sample code for java.io.IOException definition code for java.io.IOException 
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

Parameters:
key - key with which the specified value is to be associated.
stream - stream to be associated with the specified key. If this parameter is null, the specified key is removed in this applet context.
Throws:
IOException - if the stream size exceeds a certain size limit. Size limit is decided by the implementor of this interface.
IOException sample code for java.io.IOException definition code for java.io.IOException
Since:
JDK1.4

getStream sample code for java.applet.AppletContext.getStream(java.lang.String) definition code for java.applet.AppletContext.getStream(java.lang.String)

InputStream sample code for java.io.InputStream definition code for java.io.InputStream  getStream(String sample code for java.lang.String definition code for java.lang.String  key)
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

Parameters:
key - key whose associated stream is to be returned.
Returns:
the stream to which this applet context maps the key
Since:
JDK1.4

getStreamKeys sample code for java.applet.AppletContext.getStreamKeys() definition code for java.applet.AppletContext.getStreamKeys()

Iterator sample code for java.util.Iterator definition code for java.util.Iterator <String sample code for java.lang.String definition code for java.lang.String > 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

Returns:
an Iterator of all the names of the streams in this applet context.
Since:
JDK1.4