Class Applet
- All Implemented Interfaces:
ImageObserver
,MenuContainer
,Serializable
,Accessible
- Direct Known Subclasses:
JApplet
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.
- Since:
- 1.0
- See Also:
-
Nested Class Summary
Modifier and TypeClassDescriptionprotected class
Deprecated, for removal: This API element is subject to removal in a future version.This class implements accessibility support for theApplet
class.Nested classes/interfaces declared in class java.awt.Panel
Panel.AccessibleAWTPanel
Nested classes/interfaces declared in class java.awt.Container
Container.AccessibleAWTContainer
Nested classes/interfaces declared in class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
Field Summary
Fields declared in class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Fields declared in interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
Constructor Summary
ConstructorDescriptionApplet()
Deprecated, for removal: This API element is subject to removal in a future version.Constructs a new Applet. -
Method Summary
Modifier and TypeMethodDescriptionvoid
destroy()
Deprecated, for removal: This API element is subject to removal in a future version.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.Deprecated, for removal: This API element is subject to removal in a future version.Gets theAccessibleContext
associated with thisApplet
.Deprecated, for removal: This API element is subject to removal in a future version.Determines this applet's context, which allows the applet to query and affect the environment in which it runs.Deprecated, for removal: This API element is subject to removal in a future version.Returns information about this applet.getAudioClip
(URL url) Deprecated, for removal: This API element is subject to removal in a future version.Returns theAudioClip
object specified by theURL
argument.getAudioClip
(URL url, String name) Deprecated, for removal: This API element is subject to removal in a future version.Returns theAudioClip
object specified by theURL
andname
arguments.Deprecated, for removal: This API element is subject to removal in a future version.Gets the baseURL
.Deprecated, for removal: This API element is subject to removal in a future version.Gets theURL
of the document in which this applet is embedded.Deprecated, for removal: This API element is subject to removal in a future version.Returns anImage
object that can then be painted on the screen.Deprecated, for removal: This API element is subject to removal in a future version.Returns anImage
object that can then be painted on the screen.Deprecated, for removal: This API element is subject to removal in a future version.Gets the locale of the applet.getParameter
(String name) Deprecated, for removal: This API element is subject to removal in a future version.Returns the value of the named parameter in the HTML tag.String[][]
Deprecated, for removal: This API element is subject to removal in a future version.Returns information about the parameters that are understood by this applet.void
init()
Deprecated, for removal: This API element is subject to removal in a future version.Called by the browser or applet viewer to inform this applet that it has been loaded into the system.boolean
isActive()
Deprecated, for removal: This API element is subject to removal in a future version.Determines if this applet is active.boolean
Deprecated, for removal: This API element is subject to removal in a future version.Indicates if this container is a validate root.static final AudioClip
newAudioClip
(URL url) Deprecated, for removal: This API element is subject to removal in a future version.Get an audio clip from the givenURL
.void
Deprecated, for removal: This API element is subject to removal in a future version.Plays the audio clip at the specified absoluteURL
.void
Deprecated, for removal: This API element is subject to removal in a future version.Plays the audio clip given theURL
and a specifier that is relative to it.void
resize
(int width, int height) Deprecated, for removal: This API element is subject to removal in a future version.Requests that this applet be resized.void
Deprecated, for removal: This API element is subject to removal in a future version.Requests that this applet be resized.final void
setStub
(AppletStub stub) Deprecated, for removal: This API element is subject to removal in a future version.Sets this applet's stub.void
showStatus
(String msg) Deprecated, for removal: This API element is subject to removal in a future version.Requests that the argument string be displayed in the "status window".void
start()
Deprecated, for removal: This API element is subject to removal in a future version.Called by the browser or applet viewer to inform this applet that it should start its execution.void
stop()
Deprecated, for removal: This API element is subject to removal in a future version.Called by the browser or applet viewer to inform this applet that it should stop its execution.Methods declared in class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree
Methods declared in class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
Constructor Details
-
Applet
Deprecated, for removal: This API element is subject to removal in a future version.Constructs a new Applet.Note: Many methods in
java.applet.Applet
may be invoked by the applet only after the applet is fully constructed; applet should avoid calling methods injava.applet.Applet
in the constructor.- Throws:
HeadlessException
- ifGraphicsEnvironment.isHeadless()
returnstrue
- Since:
- 1.4
- See Also:
-
-
Method Details
-
setStub
Deprecated, for removal: This API element is subject to removal in a future version.Sets this applet's stub. This is done automatically by the system.- Parameters:
stub
- the new stub
-
isActive
public boolean isActive()Deprecated, for removal: This API element is subject to removal in a future version.Determines if this applet is active. An applet is marked active just before itsstart
method is called. It becomes inactive just before itsstop
method is called.- Returns:
true
if the applet is active;false
otherwise- See Also:
-
getDocumentBase
Deprecated, for removal: This API element is subject to removal in a future version.Gets theURL
of the document in which this applet is embedded. For example, suppose an applet is contained within the document:
The document base is:http://www.oracle.com/technetwork/java/index.html
http://www.oracle.com/technetwork/java/index.html
- Returns:
- the
URL
of the document that contains this applet - See Also:
-
getCodeBase
-
getParameter
Deprecated, for removal: This API element is subject to removal in a future version.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.- Parameters:
name
- a parameter name- Returns:
- the value of the named parameter, or
null
if not set
-
getAppletContext
Deprecated, for removal: This API element is subject to removal in a future version.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.
- Returns:
- the applet's context
-
resize
public void resize(int width, int height) Deprecated, for removal: This API element is subject to removal in a future version.Requests that this applet be resized. -
resize
-
isValidateRoot
public boolean isValidateRoot()Deprecated, for removal: This API element is subject to removal in a future version.Indicates if this container is a validate root.Applet
objects are the validate roots, and, therefore, they override this method to returntrue
.- Overrides:
isValidateRoot
in classContainer
- Returns:
true
- Since:
- 1.7
- See Also:
-
showStatus
Deprecated, for removal: This API element is subject to removal in a future version.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:
msg
- a string to display in the status window
-
getImage
Deprecated, for removal: This API element is subject to removal in a future version.Returns anImage
object that can then be painted on the screen. Theurl
that is passed as an argument must specify an absoluteURL
.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.
- Parameters:
url
- an absoluteURL
giving the location of the image- Returns:
- the image at the specified
URL
- See Also:
-
getImage
Deprecated, for removal: This API element is subject to removal in a future version.Returns anImage
object that can then be painted on the screen. Theurl
argument must specify an absoluteURL
. Thename
argument is a specifier that is relative to theurl
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.
- Parameters:
url
- an absolute URL giving the base location of the imagename
- the location of the image, relative to theurl
argument- Returns:
- the image at the specified
URL
- See Also:
-
newAudioClip
-
getAudioClip
Deprecated, for removal: This API element is subject to removal in a future version.Returns theAudioClip
object specified by theURL
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.
- Parameters:
url
- an absoluteURL
giving the location of the audio clip- Returns:
- the audio clip at the specified
URL
- See Also:
-
getAudioClip
Deprecated, for removal: This API element is subject to removal in a future version.Returns theAudioClip
object specified by theURL
andname
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.
- Parameters:
url
- an absoluteURL
giving the base location of the audio clipname
- the location of the audio clip, relative to theurl
argument- Returns:
- the audio clip at the specified
URL
- See Also:
-
getAppletInfo
Deprecated, for removal: This API element is subject to removal in a future version.Returns information about this applet. An applet should override this method to return aString
containing information about the author, version, and copyright of the applet.The implementation of this method provided by the
Applet
class returnsnull
.- Returns:
- a string containing information about the author, version, and copyright of the applet
-
getLocale
Deprecated, for removal: This API element is subject to removal in a future version.Gets the locale of the applet. It allows the applet to maintain its own locale separated from the locale of the browser or appletviewer. -
getParameterInfo
Deprecated, for removal: This API element is subject to removal in a future version.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 returnsnull
.- Returns:
- an array describing the parameters this applet looks for
-
play
Deprecated, for removal: This API element is subject to removal in a future version.Plays the audio clip at the specified absoluteURL
. Nothing happens if the audio clip cannot be found.- Parameters:
url
- an absoluteURL
giving the location of the audio clip
-
play
Deprecated, for removal: This API element is subject to removal in a future version.Plays the audio clip given theURL
and a specifier that is relative to it. Nothing happens if the audio clip cannot be found.- Parameters:
url
- an absoluteURL
giving the base location of the audio clipname
- the location of the audio clip, relative to theurl
argument
-
init
public void init()Deprecated, for removal: This API element is subject to removal in a future version.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 thestart
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 theinit
method to create the threads and thedestroy
method to kill them.The implementation of this method provided by the
Applet
class does nothing.- See Also:
-
start
public void start()Deprecated, for removal: This API element is subject to removal in a future version.Called by the browser or applet viewer to inform this applet that it should start its execution. It is called after theinit
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 thestart
method to resume animation, and thestop
method to suspend the animation.Note: some methods, such as
getLocationOnScreen
, can only provide meaningful results if the applet is showing. BecauseisShowing
returnsfalse
when the applet'sstart
is first called, methods requiringisShowing
to returntrue
should be called from aComponentListener
.The implementation of this method provided by the
Applet
class does nothing.- See Also:
-
stop
public void stop()Deprecated, for removal: This API element is subject to removal in a future version.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 thestart
method to resume animation, and thestop
method to suspend the animation.The implementation of this method provided by the
Applet
class does nothing.- See Also:
-
destroy
public void destroy()Deprecated, for removal: This API element is subject to removal in a future version.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. Thestop
method will always be called beforedestroy
.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 theinit
method to create the threads and thedestroy
method to kill them.The implementation of this method provided by the
Applet
class does nothing.- See Also:
-
getAccessibleContext
Deprecated, for removal: This API element is subject to removal in a future version.Gets theAccessibleContext
associated with thisApplet
. For applets, theAccessibleContext
takes the form of anAccessibleApplet
. A newAccessibleApplet
instance is created if necessary.- Specified by:
getAccessibleContext
in interfaceAccessible
- Overrides:
getAccessibleContext
in classPanel
- Returns:
- an
AccessibleApplet
that serves as theAccessibleContext
of thisApplet
- Since:
- 1.3
-