public interface AppletContext
The methods in this interface can be used by an applet to obtain information about its environment.
Modifier and Type | Method and Description |
---|---|
Applet |
getApplet(String name)
Finds and returns the applet in the document represented by this
applet context with the given name.
|
Enumeration<Applet> |
getApplets()
Finds all the applets in the document represented by this applet
context.
|
AudioClip |
getAudioClip(URL url)
Creates an audio clip.
|
Image |
getImage(URL url)
Returns an
Image object that can then be painted on
the screen. |
InputStream |
getStream(String key)
Returns the stream to which specified key is associated within this
applet context.
|
Iterator<String> |
getStreamKeys()
Finds all the keys of the streams in this applet context.
|
void |
setStream(String key,
InputStream stream)
Associates the specified stream with the specified key in this
applet context.
|
void |
showDocument(URL url)
Requests that the browser or applet viewer show the Web page
indicated by the
url argument. |
void |
showDocument(URL url,
String target)
Requests that the browser or applet viewer show the Web page
indicated by the
url argument. |
void |
showStatus(String status)
Requests that the argument string be displayed in the
"status window".
|
AudioClip getAudioClip(URL url)
url
- an absolute URL giving the location of the audio clip.Image getImage(URL url)
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
- an absolute URL giving the location of the image.Image
Applet getApplet(String name)
name
attribute.name
- an applet name.null
if
not found.Enumeration<Applet> getApplets()
void showDocument(URL url)
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
- an absolute URL giving the location of the document.void showDocument(URL url, String target)
url
argument. The
target
argument indicates in which HTML frame the
document is to be displayed.
The target argument is interpreted as follows:
Target Argument | Description |
---|---|
"_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. |
name | Show 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
.
url
- an absolute URL giving the location of the document.target
- a String
indicating where to display
the page.void showStatus(String status)
status
- a string to display in the status window.void setStream(String key, InputStream stream) throws IOException
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
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.IOException
- if the stream size exceeds a certain
size limit. Size limit is decided by the implementor of this
interface.IOException
InputStream getStream(String 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
key
- key whose associated stream is to be returned.Iterator<String> getStreamKeys()
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
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138