Methods Summary |
---|
public void | destroy()Called by the browser or applet viewer to inform
this applet that it is being reclaimed and that it should destroy
any resources that it has allocated. The stop method
will always be called before destroy .
A subclass of Applet should override this method if
it has any operation that it wants to perform before it is
destroyed. For example, an applet with threads would use the
init method to create the threads and the
destroy method to kill them.
The implementation of this method provided by the
Applet class does nothing.
|
public javax.accessibility.AccessibleContext | getAccessibleContext()Gets the AccessibleContext associated with this Applet.
For applets, the AccessibleContext takes the form of an
AccessibleApplet.
A new AccessibleApplet instance is created if necessary.
if (accessibleContext == null) {
accessibleContext = new AccessibleApplet();
}
return accessibleContext;
|
public java.applet.AppletContext | getAppletContext()Determines this applet's context, which allows the applet to
query and affect the environment in which it runs.
This environment of an applet represents the document that
contains the applet.
return stub.getAppletContext();
|
public java.lang.String | getAppletInfo()Returns information about this applet. An applet should override
this method to return a String containing information
about the author, version, and copyright of the applet.
The implementation of this method provided by the
Applet class returns null .
return null;
|
public java.applet.AudioClip | getAudioClip(java.net.URL url)Returns the AudioClip object specified by the
URL argument.
This method always returns immediately, whether or not the audio
clip exists. When this applet attempts to play the audio clip, the
data will be loaded.
return getAppletContext().getAudioClip(url);
|
public java.applet.AudioClip | getAudioClip(java.net.URL url, java.lang.String name)Returns the AudioClip object specified by the
URL and name arguments.
This method always returns immediately, whether or not the audio
clip exists. When this applet attempts to play the audio clip, the
data will be loaded.
try {
return getAudioClip(new URL(url, name));
} catch (MalformedURLException e) {
return null;
}
|
public java.net.URL | getCodeBase()Gets the base URL. This is the URL of the directory which contains this applet.
return stub.getCodeBase();
|
public java.net.URL | getDocumentBase()Gets the URL of the document in which this applet is embedded.
For example, suppose an applet is contained
within the document:
http://java.sun.com/products/jdk/1.2/index.html
The document base is:
http://java.sun.com/products/jdk/1.2/index.html
return stub.getDocumentBase();
|
public java.awt.Image | getImage(java.net.URL url)Returns an Image object that can then be painted on
the screen. The url that is passed as an argument
must specify an absolute URL.
This method always returns immediately, whether or not the image
exists. When this 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.
return getAppletContext().getImage(url);
|
public java.awt.Image | getImage(java.net.URL url, java.lang.String name)Returns an Image object that can then be painted on
the screen. The url argument must specify an absolute
URL. The name argument is a specifier that is
relative to the url argument.
This method always returns immediately, whether or not the image
exists. When this 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.
try {
return getImage(new URL(url, name));
} catch (MalformedURLException e) {
return null;
}
|
public java.util.Locale | getLocale()Gets the Locale for the applet, if it has been set.
If no Locale has been set, then the default Locale
is returned.
Locale locale = super.getLocale();
if (locale == null) {
return Locale.getDefault();
}
return locale;
|
public java.lang.String | getParameter(java.lang.String name)Returns the value of the named parameter in the HTML tag. For
example, if this applet is specified as
<applet code="Clock" width=50 height=50>
<param name=Color value="blue">
</applet>
then a call to getParameter("Color") returns the
value "blue" .
The name argument is case insensitive.
return stub.getParameter(name);
|
public java.lang.String[][] | getParameterInfo()Returns information about the parameters that are understood by
this applet. An applet should override this method to return an
array of Strings describing these parameters.
Each element of the array should be a set of three
Strings containing the name, the type, and a
description. For example:
String pinfo[][] = {
{"fps", "1-10", "frames per second"},
{"repeat", "boolean", "repeat image loop"},
{"imgs", "url", "images directory"}
};
The implementation of this method provided by the
Applet class returns null .
return null;
|
public void | init()Called by the browser or applet viewer to inform
this applet that it has been loaded into the system. It is always
called before the first time that the start method is
called.
A subclass of Applet should override this method if
it has initialization to perform. For example, an applet with
threads would use the init method to create the
threads and the destroy method to kill them.
The implementation of this method provided by the
Applet class does nothing.
|
public boolean | isActive()Determines if this applet is active. An applet is marked active
just before its start method is called. It becomes
inactive just before its stop method is called.
if (stub != null) {
return stub.isActive();
} else { // If stub field not filled in, applet never active
return false;
}
|
public static final java.applet.AudioClip | newAudioClip(java.net.URL url)Get an audio clip from the given URL.
return new sun.applet.AppletAudioClip(url);
|
public void | play(java.net.URL url)Plays the audio clip at the specified absolute URL. Nothing
happens if the audio clip cannot be found.
AudioClip clip = getAudioClip(url);
if (clip != null) {
clip.play();
}
|
public void | play(java.net.URL url, java.lang.String name)Plays the audio clip given the URL and a specifier that is
relative to it. Nothing happens if the audio clip cannot be found.
AudioClip clip = getAudioClip(url, name);
if (clip != null) {
clip.play();
}
|
private void | readObject(java.io.ObjectInputStream s)Read an applet from an object input stream.
if (GraphicsEnvironment.isHeadless()) {
throw new HeadlessException();
}
s.defaultReadObject();
|
public void | resize(java.awt.Dimension d)Requests that this applet be resized.
resize(d.width, d.height);
|
public void | resize(int width, int height)Requests that this applet be resized.
Dimension d = size();
if ((d.width != width) || (d.height != height)) {
super.resize(width, height);
if (stub != null) {
stub.appletResize(width, height);
}
}
|
public final void | setStub(java.applet.AppletStub stub)Sets this applet's stub. This is done automatically by the system.
If there is a security manager, its checkPermission
method is called with the
AWTPermission("setAppletStub")
permission if a stub has already been set.
if (this.stub != null) {
SecurityManager s = System.getSecurityManager();
if (s != null) {
s.checkPermission(new AWTPermission("setAppletStub"));
}
}
this.stub = (AppletStub)stub;
|
public void | showStatus(java.lang.String msg)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.
getAppletContext().showStatus(msg);
|
public void | start()Called by the browser or applet viewer to inform
this applet that it should start its execution. It is called after
the init method and each time the applet is revisited
in a Web page.
A subclass of Applet should override this method if
it has any operation that it wants to perform each time the Web
page containing it is visited. For example, an applet with
animation might want to use the start method to
resume animation, and the stop method to suspend the
animation.
Note: some methods, such as getLocationOnScreen , can only
provide meaningful results if the applet is showing. Because
isShowing returns false when the applet's
start is first called, methods requiring
isShowing to return true should be called from
a ComponentListener .
The implementation of this method provided by the
Applet class does nothing.
|
public void | stop()Called by the browser or applet viewer to inform
this applet that it should stop its execution. It is called when
the Web page that contains this applet has been replaced by
another page, and also just before the applet is to be destroyed.
A subclass of Applet should override this method if
it has any operation that it wants to perform each time the Web
page containing it is no longer visible. For example, an applet
with animation might want to use the start method to
resume animation, and the stop method to suspend the
animation.
The implementation of this method provided by the
Applet class does nothing.
|