- 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
Nested ClassesModifier and TypeClassDescriptionprotected classDeprecated, for removal: This API element is subject to removal in a future version.This class implements accessibility support for theAppletclass.Nested classes/interfaces declared in class java.awt.Panel
Panel.AccessibleAWTPanelNested classes/interfaces declared in class java.awt.Container
Container.AccessibleAWTContainerNested 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_ALIGNMENTFields declared in interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH -
Constructor Summary
ConstructorsConstructorDescriptionApplet()Deprecated, for removal: This API element is subject to removal in a future version.Constructs a new Applet. -
Method Summary
Modifier and TypeMethodDescriptionvoiddestroy()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 theAccessibleContextassociated 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 theAudioClipobject specified by theURLargument.getAudioClip(URL url, String name) Deprecated, for removal: This API element is subject to removal in a future version.Returns theAudioClipobject specified by theURLandnamearguments.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 theURLof the document in which this applet is embedded.Deprecated, for removal: This API element is subject to removal in a future version.Returns anImageobject that can then be painted on the screen.Deprecated, for removal: This API element is subject to removal in a future version.Returns anImageobject 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.voidinit()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.booleanisActive()Deprecated, for removal: This API element is subject to removal in a future version.Determines if this applet is active.booleanDeprecated, for removal: This API element is subject to removal in a future version.Indicates if this container is a validate root.static final AudioClipnewAudioClip(URL url) Deprecated, for removal: This API element is subject to removal in a future version.Get an audio clip from the givenURL.voidDeprecated, for removal: This API element is subject to removal in a future version.Plays the audio clip at the specified absoluteURL.voidDeprecated, for removal: This API element is subject to removal in a future version.Plays the audio clip given theURLand a specifier that is relative to it.voidresize(int width, int height) Deprecated, for removal: This API element is subject to removal in a future version.Requests that this applet be resized.voidDeprecated, for removal: This API element is subject to removal in a future version.Requests that this applet be resized.final voidsetStub(AppletStub stub) Deprecated, for removal: This API element is subject to removal in a future version.Sets this applet's stub.voidshowStatus(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".voidstart()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.voidstop()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, validateTreeMethods 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.Appletmay be invoked by the applet only after the applet is fully constructed; applet should avoid calling methods injava.applet.Appletin 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.If there is a security manager, its
checkPermissionmethod is called with theAWTPermission("setAppletStub")permission if a stub has already been set.- Parameters:
stub- the new stub- Throws:
SecurityException- if the caller cannot set the 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 itsstartmethod is called. It becomes inactive just before itsstopmethod is called.- Returns:
trueif the applet is active;falseotherwise- See Also:
-
getDocumentBase
Deprecated, for removal: This API element is subject to removal in a future version.Gets theURLof 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.htmlhttp://www.oracle.com/technetwork/java/index.html- Returns:
- the
URLof the document that contains this applet - See Also:
-
getCodeBase
Deprecated, for removal: This API element is subject to removal in a future version.Gets the baseURL. This is theURLof the directory which contains this applet.- Returns:
- the base
URLof the directory which contains this applet - See Also:
-
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
nameargument is case insensitive.- Parameters:
name- a parameter name- Returns:
- the value of the named parameter, or
nullif 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
Deprecated, for removal: This API element is subject to removal in a future version.Requests that this applet be resized. -
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.Appletobjects are the validate roots, and, therefore, they override this method to returntrue.- Overrides:
isValidateRootin 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 anImageobject that can then be painted on the screen. Theurlthat 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 absoluteURLgiving 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 anImageobject that can then be painted on the screen. Theurlargument must specify an absoluteURL. Thenameargument is a specifier that is relative to theurlargument.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 theurlargument- Returns:
- the image at the specified
URL - See Also:
-
newAudioClip
Deprecated, for removal: This API element is subject to removal in a future version.Get an audio clip from the givenURL.- Parameters:
url- points to the audio clip- Returns:
- the audio clip at the specified
URL - Since:
- 1.2
-
getAudioClip
Deprecated, for removal: This API element is subject to removal in a future version.Returns theAudioClipobject specified by theURLargument.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 absoluteURLgiving 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 theAudioClipobject specified by theURLandnamearguments.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 absoluteURLgiving the base location of the audio clipname- the location of the audio clip, relative to theurlargument- 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 aStringcontaining information about the author, version, and copyright of the applet.The implementation of this method provided by the
Appletclass 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
Appletclass 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 absoluteURLgiving 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 theURLand a specifier that is relative to it. Nothing happens if the audio clip cannot be found.- Parameters:
url- an absoluteURLgiving the base location of the audio clipname- the location of the audio clip, relative to theurlargument
-
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 thestartmethod is called.A subclass of
Appletshould override this method if it has initialization to perform. For example, an applet with threads would use theinitmethod to create the threads and thedestroymethod to kill them.The implementation of this method provided by the
Appletclass 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 theinitmethod and each time the applet is revisited in a Web page.A subclass of
Appletshould 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 thestartmethod to resume animation, and thestopmethod to suspend the animation.Note: some methods, such as
getLocationOnScreen, can only provide meaningful results if the applet is showing. BecauseisShowingreturnsfalsewhen the applet'sstartis first called, methods requiringisShowingto returntrueshould be called from aComponentListener.The implementation of this method provided by the
Appletclass 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
Appletshould 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 thestartmethod to resume animation, and thestopmethod to suspend the animation.The implementation of this method provided by the
Appletclass 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. Thestopmethod will always be called beforedestroy.A subclass of
Appletshould 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 theinitmethod to create the threads and thedestroymethod to kill them.The implementation of this method provided by the
Appletclass does nothing.- See Also:
-
getAccessibleContext
Deprecated, for removal: This API element is subject to removal in a future version.Gets theAccessibleContextassociated with thisApplet. For applets, theAccessibleContexttakes the form of anAccessibleApplet. A newAccessibleAppletinstance is created if necessary.- Specified by:
getAccessibleContextin interfaceAccessible- Overrides:
getAccessibleContextin classPanel- Returns:
- an
AccessibleAppletthat serves as theAccessibleContextof thisApplet - Since:
- 1.3
-