public class JApplet extends Applet implements Accessible, RootPaneContainer
java.applet.Applet that adds support for
the JFC/Swing component architecture.
You can find task-oriented documentation about using JApplet
in The Java Tutorial,
in the section
How to Make Applets.
The JApplet class is slightly incompatible with
java.applet.Applet. JApplet contains a
JRootPane as its only child. The contentPane
should be the parent of any children of the JApplet.
As a convenience, the add, remove, and setLayout
methods of this class are overridden, so that they delegate calls
to the corresponding methods of the ContentPane.
For example, you can add a child component to an applet as follows:
applet.add(child);
And the child will be added to the contentPane.
The contentPane will always be non-null.
Attempting to set it to null will cause the
JApplet to throw an exception. The default
contentPane will have a BorderLayout
manager set on it.
Refer to RootPaneContainer
for details on adding, removing and setting the LayoutManager
of a JApplet.
Please see the JRootPane documentation for a
complete description of the contentPane, glassPane,
and layeredPane properties.
Warning: Swing is not thread safe. For more information see Swing's Threading Policy.
Warning:
Serialized objects of this class will not be compatible with
future Swing releases. The current serialization support is
appropriate for short term storage or RMI between applications running
the same version of Swing. As of 1.4, support for long term storage
of all JavaBeans™
has been added to the java.beans package.
Please see XMLEncoder.
RootPaneContainer| Modifier and Type | Class and Description |
|---|---|
protected class |
JApplet.AccessibleJApplet
This class implements accessibility support for the
JApplet class. |
Applet.AccessibleAppletPanel.AccessibleAWTPanelContainer.AccessibleAWTContainerComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy| Modifier and Type | Field and Description |
|---|---|
protected AccessibleContext |
accessibleContext |
protected JRootPane |
rootPane |
protected boolean |
rootPaneCheckingEnabled
If true then calls to
add and setLayout
will be forwarded to the contentPane. |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH| Constructor and Description |
|---|
JApplet()
Creates a swing applet instance.
|
| Modifier and Type | Method and Description |
|---|---|
protected void |
addImpl(Component comp,
Object constraints,
int index)
Adds the specified child
Component. |
protected JRootPane |
createRootPane()
Called by the constructor methods to create the default rootPane.
|
AccessibleContext |
getAccessibleContext()
Gets the AccessibleContext associated with this JApplet.
|
Container |
getContentPane()
Returns the contentPane object for this applet.
|
Component |
getGlassPane()
Returns the glassPane object for this applet.
|
Graphics |
getGraphics()
Creates a graphics context for this component.
|
JMenuBar |
getJMenuBar()
Returns the menubar set on this applet.
|
JLayeredPane |
getLayeredPane()
Returns the layeredPane object for this applet.
|
JRootPane |
getRootPane()
Returns the rootPane object for this applet.
|
TransferHandler |
getTransferHandler()
Gets the
transferHandler property. |
protected boolean |
isRootPaneCheckingEnabled()
Returns whether calls to
add and
setLayout are forwarded to the contentPane. |
protected String |
paramString()
Returns a string representation of this JApplet.
|
void |
remove(Component comp)
Removes the specified component from the container.
|
void |
repaint(long time,
int x,
int y,
int width,
int height)
Repaints the specified rectangle of this component within
time milliseconds. |
void |
setContentPane(Container contentPane)
Sets the contentPane property.
|
void |
setGlassPane(Component glassPane)
Sets the glassPane property.
|
void |
setJMenuBar(JMenuBar menuBar)
Sets the menubar for this applet.
|
void |
setLayeredPane(JLayeredPane layeredPane)
Sets the layeredPane property.
|
void |
setLayout(LayoutManager manager)
Sets the
LayoutManager. |
protected void |
setRootPane(JRootPane root)
Sets the rootPane property.
|
protected void |
setRootPaneCheckingEnabled(boolean enabled)
Sets whether calls to
add and
setLayout are forwarded to the contentPane. |
void |
setTransferHandler(TransferHandler newHandler)
Sets the
transferHandler property, which is a mechanism to
support transfer of data into this component. |
void |
update(Graphics g)
Just calls
paint(g). |
destroy, getAppletContext, getAppletInfo, getAudioClip, getAudioClip, getCodeBase, getDocumentBase, getImage, getImage, getLocale, getParameter, getParameterInfo, init, isActive, isValidateRoot, newAudioClip, play, play, resize, resize, setStub, showStatus, start, stopadd, add, add, add, add, addContainerListener, 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, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTreeaction, 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, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycleprotected JRootPane rootPane
getRootPane(),
setRootPane(javax.swing.JRootPane)protected boolean rootPaneCheckingEnabled
add and setLayout
will be forwarded to the contentPane. This is initially
false, but is set to true when the JApplet is constructed.protected AccessibleContext accessibleContext
public JApplet()
throws HeadlessException
This constructor sets the component's locale property to the value
returned by JComponent.getDefaultLocale.
HeadlessException - if GraphicsEnvironment.isHeadless()
returns true.GraphicsEnvironment.isHeadless(),
JComponent.getDefaultLocale()protected JRootPane createRootPane()
public void setTransferHandler(TransferHandler newHandler)
transferHandler property, which is a mechanism to
support transfer of data into this component. Use null
if the component does not support data transfer operations.
If the system property suppressSwingDropSupport is false
(the default) and the current drop target on this component is either
null or not a user-set drop target, this method will change the
drop target as follows: If newHandler is null it will
clear the drop target. If not null it will install a new
DropTarget.
Note: When used with JApplet, TransferHandler only
provides data import capability, as the data export related methods
are currently typed to JComponent.
Please see How to Use Drag and Drop and Data Transfer, a section in The Java Tutorial, for more information.
newHandler - the new TransferHandlerTransferHandler,
getTransferHandler(),
Component.setDropTarget(java.awt.dnd.DropTarget)public TransferHandler getTransferHandler()
transferHandler property.transferHandler propertyTransferHandler,
setTransferHandler(javax.swing.TransferHandler)public void update(Graphics g)
paint(g). This method was overridden to
prevent an unnecessary call to clear the background.update in class Containerg - the specified Graphics windowComponent.update(Graphics)public void setJMenuBar(JMenuBar menuBar)
menuBar - the menubar being placed in the appletgetJMenuBar()public JMenuBar getJMenuBar()
setJMenuBar(javax.swing.JMenuBar)protected boolean isRootPaneCheckingEnabled()
add and
setLayout are forwarded to the contentPane.add and setLayout
are forwarded; false otherwiseaddImpl(java.awt.Component, java.lang.Object, int),
setLayout(java.awt.LayoutManager),
setRootPaneCheckingEnabled(boolean),
RootPaneContainerprotected void setRootPaneCheckingEnabled(boolean enabled)
add and
setLayout are forwarded to the contentPane.enabled - true if add and setLayout
are forwarded, false if they should operate directly on the
JApplet.addImpl(java.awt.Component, java.lang.Object, int),
setLayout(java.awt.LayoutManager),
isRootPaneCheckingEnabled(),
RootPaneContainerprotected void addImpl(Component comp, Object constraints, int index)
Component.
This method is overridden to conditionally forward calls to the
contentPane.
By default, children are added to the contentPane instead
of the frame, refer to RootPaneContainer for
details.addImpl in class Containercomp - the component to be enhancedconstraints - the constraints to be respectedindex - the indexIllegalArgumentException - if index is invalidIllegalArgumentException - if adding the container's parent
to itselfIllegalArgumentException - if adding a window to a containersetRootPaneCheckingEnabled(boolean),
RootPaneContainerpublic void remove(Component comp)
comp is not the rootPane, this will forward
the call to the contentPane. This will do nothing if
comp is not a child of the JFrame or
contentPane.remove in class Containercomp - the component to be removedNullPointerException - if comp is nullContainer.add(java.awt.Component),
RootPaneContainerpublic void setLayout(LayoutManager manager)
LayoutManager.
Overridden to conditionally forward the call to the
contentPane.
Refer to RootPaneContainer for
more information.setLayout in class Containermanager - the LayoutManagersetRootPaneCheckingEnabled(boolean),
RootPaneContainerpublic JRootPane getRootPane()
getRootPane in interface RootPaneContainersetRootPane(javax.swing.JRootPane),
RootPaneContainer.getRootPane()protected void setRootPane(JRootPane root)
root - the rootPane object for this appletgetRootPane()public Container getContentPane()
getContentPane in interface RootPaneContainersetContentPane(java.awt.Container),
RootPaneContainer.getContentPane()public void setContentPane(Container contentPane)
setContentPane in interface RootPaneContainercontentPane - the contentPane object for this appletIllegalComponentStateException - (a runtime
exception) if the content pane parameter is nullgetContentPane(),
RootPaneContainer.setContentPane(java.awt.Container)public JLayeredPane getLayeredPane()
getLayeredPane in interface RootPaneContainerIllegalComponentStateException - (a runtime
exception) if the layered pane parameter is nullsetLayeredPane(javax.swing.JLayeredPane),
RootPaneContainer.getLayeredPane()public void setLayeredPane(JLayeredPane layeredPane)
setLayeredPane in interface RootPaneContainerlayeredPane - the layeredPane object for this appletgetLayeredPane(),
RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)public Component getGlassPane()
getGlassPane in interface RootPaneContainersetGlassPane(java.awt.Component),
RootPaneContainer.getGlassPane()public void setGlassPane(Component glassPane)
setGlassPane in interface RootPaneContainerglassPane - the glassPane object for this appletgetGlassPane(),
RootPaneContainer.setGlassPane(java.awt.Component)public Graphics getGraphics()
null if this component is currently not
displayable.getGraphics in class Componentnull
if it has noneComponent.paint(java.awt.Graphics)public void repaint(long time,
int x,
int y,
int width,
int height)
time milliseconds. Refer to RepaintManager
for details on how the repaint is handled.repaint in class Componenttime - maximum time in milliseconds before updatex - the x coordinatey - the y coordinatewidth - the widthheight - the heightRepaintManagerprotected String paramString()
null.paramString in class Containerpublic AccessibleContext getAccessibleContext()
getAccessibleContext in interface AccessiblegetAccessibleContext in class Applet 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, 2017, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.