The Applet
class must be the superclass of any applet that is to be embedded in a Web page or viewed by the Java Applet Viewer. The Applet
class provides a standard interface between applets and their environment.
Field Detail |
private transient AppletStub stub
Method Detail |
public final void setStub(AppletStub stub)
stub
- the new stub.public boolean isActive()
start
method is called. It becomes inactive just before its stop
method is called.true
if the applet is active; false
otherwise.public URL getDocumentBase()
The document base is:http://java.sun.com/products/jdk/1.2/index.html
http://java.sun.com/products/jdk/1.2/
public URL getCodeBase()
public String getParameter(String name)
<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.
name
- a parameter name.null
if not set.public AppletContext getAppletContext()
This environment of an applet represents the document that contains the applet.
public void resize(int width, int height)
width
- the new requested width for the applet.height
- the new requested height for the applet.public void resize(Dimension d)
d
- an object giving the new width and height.public void showStatus(String msg)
msg
- a string to display in the status window.public Image getImage(URL url)
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.
url
- an absolute URL giving the location of the image.public Image getImage(URL url, String name)
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.
url
- an absolute URL giving the base location of the image.name
- the location of the image, relative to the url
argument.public static final AudioClip newAudioClip(URL url)
url
- points to the audio clippublic AudioClip getAudioClip(URL url)
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.
url
- an absolute URL giving the location of the audio clip.public AudioClip getAudioClip(URL url, String name)
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.
url
- an absolute URL giving the base location of the audio clip.name
- the location of the audio clip, relative to the url
argument.public String getAppletInfo()
String
containing information about the author, version, and copyright of the applet. The implementation of this method provided by the Applet
class returns null
.
public Locale getLocale()
public String[][] getParameterInfo()
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
.
public void play(URL url)
url
- an absolute URL giving the location of the audio clip.public void play(URL url, String name)
url
- an absolute URL giving the base location of the audio clip.name
- the location of the audio clip, relative to the url
argument.public void init()
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 void start()
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.
The implementation of this method provided by the Applet
class does nothing.
public void stop()
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.
public void destroy()
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 AccessibleContext getAccessibleContext()