Module java.desktop

Package javax.swing

Class JApplet

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Panel

java.applet.Applet

javax.swing.JApplet

所有已实现的接口:

ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer

       @Deprecated(since="9", forRemoval=true) @JavaBean(defaultProperty="JMenuBar", description="Swing\'s Applet subclass.") public class JApplet extends Applet implements Accessible, RootPaneContainer
      

Deprecated, for removal: This API element is subject to removal in a future version.

The Applet API is deprecated, no replacement.

一个扩展版本的java.applet.Applet，增加了对JFC/Swing组件架构的支持。您可以在The Java Tutorial的How to Make Applets部分找到关于如何使用JApplet的面向任务的文档。

JApplet类与java.applet.Applet略有不兼容。 JApplet包含一个JRootPane作为其唯一子级。 contentPane应该是JApplet的任何子级的父级。 作为一种便利，此类的add、remove和setLayout方法被覆盖，以便它们将调用委托给ContentPane的相应方法。 例如，您可以按如下方式向applet添加子组件：

       applet.add(child);
 

然后子组件将被添加到contentPane。 contentPane将始终为非null。 尝试将其设置为null将导致JApplet抛出异常。 默认的contentPane将具有BorderLayout管理器设置在其上。 有关如何向JApplet添加、移除和设置LayoutManager的详细信息，请参阅RootPaneContainer。

请参阅JRootPane文档，了解contentPane、glassPane和layeredPane属性的完整描述。

警告: Swing不是线程安全的。有关更多信息，请参阅Swing的线程策略。

警告: 此类的序列化对象将不兼容未来的Swing版本。当前的序列化支持适用于短期存储或在运行相同版本Swing的应用程序之间的RMI。 从1.4开始，已将所有JavaBeans的长期存储支持添加到java.beans包中。 请参阅XMLEncoder。

自:

1.2

参见:

• RootPaneContainer

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	JApplet.AccessibleJApplet	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 该类为JApplet类实现了辅助功能支持。

Nested classes/interfaces declared in class java.applet.Applet

Applet.AccessibleApplet

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

Modifier and Type	Field	Description
protected AccessibleContext	accessibleContext	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 与此JApplet关联的AccessibleContext
protected JRootPane	rootPane	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 管理contentPane的JRootPane实例。
protected boolean	rootPaneCheckingEnabled	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 如果为true，则对add和setLayout的调用将被转发到contentPane。

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

Constructors

Constructor	Description
JApplet()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 创建一个Swing applet实例。

Method Summary

Modifier and Type	Method	Description
protected void	addImpl(Component comp, Object constraints, int index)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 添加指定的子Component。
protected JRootPane	createRootPane()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 由构造方法调用以创建默认的rootPane。
AccessibleContext	getAccessibleContext()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 获取与此JApplet关联的AccessibleContext。
Container	getContentPane()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 返回此applet的contentPane对象。
Component	getGlassPane()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 返回此applet的glassPane对象。
Graphics	getGraphics()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 为此组件创建一个图形上下文。
JMenuBar	getJMenuBar()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 返回设置在此applet上的菜单栏。
JLayeredPane	getLayeredPane()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 返回此applet的layeredPane对象。
JRootPane	getRootPane()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 返回此applet的rootPane对象。
TransferHandler	getTransferHandler()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 获取transferHandler属性。
protected boolean	isRootPaneCheckingEnabled()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 返回是否将add和setLayout的调用转发到contentPane。
protected String	paramString()	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 返回此JApplet的字符串表示形式。
void	remove(Component comp)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 从容器中移除指定的组件。
void	repaint(long time, int x, int y, int width, int height)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 在time毫秒内重绘此组件的指定矩形。
void	setContentPane(Container contentPane)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 设置contentPane属性。
void	setGlassPane(Component glassPane)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 设置glassPane属性。
void	setJMenuBar(JMenuBar menuBar)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 设置此applet的菜单栏。
void	setLayeredPane(JLayeredPane layeredPane)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 设置layeredPane属性。
void	setLayout(LayoutManager manager)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 设置LayoutManager。
protected void	setRootPane(JRootPane root)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 设置rootPane属性。
protected void	setRootPaneCheckingEnabled(boolean enabled)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 设置是否将add和setLayout的调用转发到contentPane。
void	setTransferHandler(TransferHandler newHandler)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 设置transferHandler属性，这是支持将数据传输到此组件的机制。
void	update(Graphics g)	已弃用，将被移除: 此API元素可能在将来的版本中被移除。 仅调用paint(g)。

Methods declared in class java.applet.Applet

destroy, getAppletContext, getAppletInfo, getAudioClip, getAudioClip, getCodeBase, getDocumentBase, getImage, getImage, getLocale, getParameter, getParameterInfo, init, isActive, isValidateRoot, newAudioClip, play, play, resize, resize, setStub, showStatus, start, stop

Methods declared in class java.awt.Panel

addNotify

Methods declared in class java.awt.Container

add, 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, 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, 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, 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

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

rootPane

             protected JRootPane rootPane
            

Deprecated, for removal: This API element is subject to removal in a future version.

管理contentPane的JRootPane实例。

参见:

• getRootPane()
• setRootPane(javax.swing.JRootPane)

rootPaneCheckingEnabled

             protected boolean rootPaneCheckingEnabled
            

Deprecated, for removal: This API element is subject to removal in a future version.

如果为true，则对add和setLayout的调用将被转发到contentPane。 初始值为false，但在构造JApplet时设置为true。

参见:

• isRootPaneCheckingEnabled()
• setRootPaneCheckingEnabled(boolean)
• RootPaneContainer

accessibleContext

             protected AccessibleContext accessibleContext
            

Deprecated, for removal: This API element is subject to removal in a future version.

与此JApplet关联的AccessibleContext

Constructor Details

JApplet

             public JApplet() throws HeadlessException
            

Deprecated, for removal: This API element is subject to removal in a future version.

创建一个Swing applet实例。

此构造方法将组件的locale属性设置为JComponent.getDefaultLocale返回的值。

抛出:

HeadlessException - 如果GraphicsEnvironment.isHeadless()返回true。

参见:

• GraphicsEnvironment.isHeadless()
• JComponent.getDefaultLocale()

Method Details

createRootPane

             protected JRootPane createRootPane()
            

Deprecated, for removal: This API element is subject to removal in a future version.

由构造方法调用以创建默认的rootPane。

返回:

一个新的 JRootPane

setTransferHandler

             @BeanProperty(hidden=true, description="Mechanism for transfer of data into the component") public void setTransferHandler(TransferHandler newHandler)
            

Deprecated, for removal: This API element is subject to removal in a future version.

设置 transferHandler 属性，这是一种支持将数据传输到此组件的机制。如果组件不支持数据传输操作，请使用 null。

如果系统属性 suppressSwingDropSupport 为 false（默认值），并且此组件上的当前放置目标要么是 null，要么不是用户设置的放置目标，则此方法将按以下方式更改放置目标：如果 newHandler 为 null，它将清除放置目标。如果不为 null，它将安装一个新的 DropTarget。

注意：当与 JApplet 一起使用时，TransferHandler 仅提供数据导入功能，因为数据导出相关方法当前是针对 JComponent 类型的。

更多信息请参阅 如何使用拖放和数据传输，这是 The Java Tutorial 中的一个章节。

参数:

newHandler - 新的 TransferHandler

自版本:

1.6

另请参阅:

• TransferHandler
• getTransferHandler()
• Component.setDropTarget(java.awt.dnd.DropTarget)

getTransferHandler

             public TransferHandler getTransferHandler()
            

Deprecated, for removal: This API element is subject to removal in a future version.

获取 transferHandler 属性。

返回:

transferHandler 属性的值

自版本:

1.6

另请参阅:

• TransferHandler
• setTransferHandler(javax.swing.TransferHandler)

update

             public void update(Graphics g)
            

Deprecated, for removal: This API element is subject to removal in a future version.

只调用 paint(g)。重写此方法是为了防止不必要地清除背景。

覆盖:

update 在类 Container 中

参数:

g - 指定的 Graphics 窗口

另请参阅:

• Component.update(Graphics)

setJMenuBar

             @BeanProperty(bound=false, hidden=true, description="The menubar for accessing pulldown menus from this applet.") public void setJMenuBar(JMenuBar menuBar)
            

Deprecated, for removal: This API element is subject to removal in a future version.

为此 applet 设置菜单栏。

参数:

menuBar - 要放置在 applet 中的菜单栏

另请参阅:

• getJMenuBar()

getJMenuBar

             public JMenuBar getJMenuBar()
            

Deprecated, for removal: This API element is subject to removal in a future version.

返回在此 applet 上设置的菜单栏。

返回:

在此 applet 上设置的菜单栏

另请参阅:

• setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

             protected boolean isRootPaneCheckingEnabled()
            

Deprecated, for removal: This API element is subject to removal in a future version.

返回是否将 add 和 setLayout 的调用转发到 contentPane。

返回:

如果将 add 和 setLayout 的调用转发，则返回 true；否则返回 false

另请参阅:

• addImpl(java.awt.Component, java.lang.Object, int)
• setLayout(java.awt.LayoutManager)
• setRootPaneCheckingEnabled(boolean)
• RootPaneContainer

setRootPaneCheckingEnabled

             @BeanProperty(hidden=true, description="Whether the add and setLayout methods are forwarded") protected void setRootPaneCheckingEnabled(boolean enabled)
            

Deprecated, for removal: This API element is subject to removal in a future version.

设置是否将 add 和 setLayout 的调用转发到 contentPane。

参数:

enabled - 如果将 add 和 setLayout 的调用转发，则为 true；如果应直接在 JApplet 上操作，则为 false。

另请参阅:

• addImpl(java.awt.Component, java.lang.Object, int)
• setLayout(java.awt.LayoutManager)
• isRootPaneCheckingEnabled()
• RootPaneContainer

addImpl

             protected void addImpl(Component comp, Object constraints, int index)
            

Deprecated, for removal: This API element is subject to removal in a future version.

添加指定的子 Component。重写此方法以有条件地将调用转发到 contentPane。默认情况下，子组件将添加到 contentPane 而不是框架，请参考 RootPaneContainer 以获取详细信息。

覆盖:

addImpl 在类 Container 中

参数:

comp - 要增强的组件

constraints - 要遵守的约束

index - 索引

抛出:

IllegalArgumentException - 如果 index 无效

IllegalArgumentException - 如果将容器的父级添加到自身

IllegalArgumentException - 如果将窗口添加到容器

另请参阅:

• setRootPaneCheckingEnabled(boolean)
• RootPaneContainer

remove

             public void remove(Component comp)
            

Deprecated, for removal: This API element is subject to removal in a future version.

从容器中移除指定的组件。如果 comp 不是 rootPane，则会将此调用转发到 contentPane。如果 comp 不是 JFrame 或 contentPane 的子级，则不会执行任何操作。

覆盖:

remove 在类 Container 中

参数:

comp - 要移除的组件

抛出:

NullPointerException - 如果 comp 为 null

另请参阅:

• Container.add(java.awt.Component)
• RootPaneContainer

setLayout

             public void setLayout(LayoutManager manager)
            

Deprecated, for removal: This API element is subject to removal in a future version.

设置 LayoutManager。重写此方法以有条件地将调用转发到 contentPane。有关更多信息，请参考 RootPaneContainer。

覆盖:

setLayout 在类 Container 中

参数:

manager - LayoutManager

另请参阅:

• setRootPaneCheckingEnabled(boolean)
• RootPaneContainer

getRootPane

             @BeanProperty(bound=false, hidden=true, description="the RootPane object for this applet.") public JRootPane getRootPane()
            

Deprecated, for removal: This API element is subject to removal in a future version.

返回此 applet 的 rootPane 对象。

指定者:

getRootPane 在接口 RootPaneContainer 中

返回:

此组件的单个 JRootPane 子级。

另请参阅:

• setRootPane(javax.swing.JRootPane)
• RootPaneContainer.getRootPane()

setRootPane

             protected void setRootPane(JRootPane root)
            

Deprecated, for removal: This API element is subject to removal in a future version.

设置 rootPane 属性。此方法由构造函数调用。

参数:

root - 此 applet 的 rootPane 对象

另请参阅:

• getRootPane()

getContentPane

             public Container getContentPane()
            

Deprecated, for removal: This API element is subject to removal in a future version.

返回此 applet 的 contentPane 对象。

指定者:

getContentPane 在接口 RootPaneContainer 中

返回:

contentPane 属性的值。

另请参阅:

• setContentPane(java.awt.Container)
• RootPaneContainer.getContentPane()

setContentPane

             @BeanProperty(bound=false, hidden=true, description="The client area of the applet where child components are normally inserted.") public void setContentPane(Container contentPane)
            

Deprecated, for removal: This API element is subject to removal in a future version.

设置 contentPane 属性。此方法由构造函数调用。

指定由：

setContentPane 在接口 RootPaneContainer中

参数：

contentPane - 该applet的contentPane对象

抛出：

IllegalComponentStateException - 如果content pane参数为null（运行时异常）

参见：

• getContentPane()
• RootPaneContainer.setContentPane(java.awt.Container)

getLayeredPane

             public JLayeredPane getLayeredPane()
            

Deprecated, for removal: This API element is subject to removal in a future version.

返回该applet的layeredPane对象。

指定由：

getLayeredPane 在接口 RootPaneContainer中

返回：

layeredPane属性的值。

抛出：

IllegalComponentStateException - 如果layered pane参数为null（运行时异常）

参见：

• setLayeredPane(javax.swing.JLayeredPane)
• RootPaneContainer.getLayeredPane()

setLayeredPane

             @BeanProperty(bound=false, hidden=true, description="The pane which holds the various applet layers.") public void setLayeredPane(JLayeredPane layeredPane)
            

Deprecated, for removal: This API element is subject to removal in a future version.

设置layeredPane属性。此方法由构造函数调用。

指定由：

setLayeredPane 在接口 RootPaneContainer中

参数：

layeredPane - 该applet的layeredPane对象

参见：

• getLayeredPane()
• RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

             public Component getGlassPane()
            

Deprecated, for removal: This API element is subject to removal in a future version.

返回该applet的glassPane对象。

指定由：

getGlassPane 在接口 RootPaneContainer中

返回：

glassPane属性的值。

参见：

• setGlassPane(java.awt.Component)
• RootPaneContainer.getGlassPane()

setGlassPane

             @BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.") public void setGlassPane(Component glassPane)
            

Deprecated, for removal: This API element is subject to removal in a future version.

设置glassPane属性。此方法由构造函数调用。

指定由：

setGlassPane 在接口 RootPaneContainer中

参数：

glassPane - 该applet的glassPane对象

参见：

• getGlassPane()
• RootPaneContainer.setGlassPane(java.awt.Component)

getGraphics

             @BeanProperty(bound=false) public Graphics getGraphics()
            

Deprecated, for removal: This API element is subject to removal in a future version.

为此组件创建一个图形上下文。如果此组件当前不可显示，则此方法将返回null。

覆盖：

getGraphics 在类 Component中

返回：

该组件的图形上下文，如果没有则返回null

自：

1.6

参见：

• Component.paint(java.awt.Graphics)

repaint

             public void repaint(long time, int x, int y, int width, int height)
            

Deprecated, for removal: This API element is subject to removal in a future version.

在time毫秒内重新绘制此组件的指定矩形。有关重绘如何处理的详细信息，请参阅RepaintManager。

覆盖：

repaint 在类 Component中

参数：

time - 更新前的最大时间（毫秒）

x - x坐标

y - y坐标

width - 宽度

height - 高度

自：

1.6

参见：

• RepaintManager

paramString

             protected String paramString()
            

Deprecated, for removal: This API element is subject to removal in a future version.

返回此JApplet的字符串表示形式。此方法仅用于调试目的，返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但不能为null。

覆盖：

paramString 在类 Container中

返回：

此JApplet的字符串表示形式。

getAccessibleContext

             public AccessibleContext getAccessibleContext()
            

Deprecated, for removal: This API element is subject to removal in a future version.

获取与此JApplet关联的AccessibleContext。对于JApplets，AccessibleContext采用AccessibleJApplet的形式。如有必要，将创建一个新的AccessibleJApplet实例。

指定由：

getAccessibleContext 在接口 Accessible中

覆盖：

getAccessibleContext 在类 Applet中

返回：

作为此JApplet的AccessibleContext的AccessibleJApplet