    All Packages  Class Hierarchy  This Package  Previous  Next  Index

# Interface java.applet.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.

##

getApplet(String)
  Finds and returns the applet in the document represented by this applet context with the given name.
getApplets()
  Finds all the applets in the document represented by this applet context.
getAudioClip(URL)
  Creates an audio clip.
getImage(URL)
  Returns an `Image` object that can then be painted on the screen.
showDocument(URL)
  Replaces the Web page currently being viewed with the given URL.
showDocument(URL, String)
  Requests that the browser or applet viewer show the Web page indicated by the `url` argument.
showStatus(String)
  Requests that the argument string be displayed in the "status window".

##

getAudioClip

      public abstract AudioClip getAudioClip(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

      public abstract Image getImage(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

getApplet

      public abstract Applet getApplet(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

      public abstract Enumeration 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

      public abstract void showDocument(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

      public abstract void showDocument(URL url,
                                        String target)

  Requests that the browser or applet viewer show the Web page indicated by the `url` argument. The `target` argument indicates where to display the frame. The target argument is interpreted as follows:

  `"_self"` | show in the current frame
  `"_parent"` | show in the parent frame
  `"_top"` | show in the topmost frame
  `"_blank"` | show in a new unnamed top-level window
  name | show in a new top-level window named name

  An applet viewer or browser is free to ignore `showDocument`.

  Parameters:
    target - a `String` indicating where to display the page.

showStatus

      public abstract void showStatus(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.

    All Packages  Class Hierarchy  This Package  Previous  Next  Index