模块 java.desktop

包 javax.swing

类 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 
      

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

Applet API 已弃用，没有替代品。

java.applet.Applet 的扩展版本，增加了对 JFC/Swing 组件架构的支持。您可以在 如何制作小程序 部分找到有关在 The Java Tutorial 中使用 JApplet 的面向任务的文档。

JApplet 类与 java.applet.Applet 稍微不兼容。 JApplet 包含一个 JRootPane 作为其唯一的孩子。 contentPane 应该是 JApplet 的任何子级的父级。为方便起见，覆盖了此类的 add、remove 和 setLayout 方法，以便它们将调用委托给 ContentPane 的相应方法。例如，您可以将子组件添加到小程序，如下所示：

    applet.add(child);
 

并且孩子将被添加到 contentPane。 contentPane 将始终是非 null 。尝试将其设置为 null 将导致 JApplet 引发异常。默认的 contentPane 将设置一个 BorderLayout 管理器。有关添加、删除和设置 JApplet 的 LayoutManager 的详细信息，请参阅 RootPaneContainer 。

有关 contentPane、glassPane 和 layeredPane 属性的完整说明，请参阅 JRootPane 文档。

Warning: Swing 不是线程安全的。有关详细信息，请参阅 Swing 的线程策略。

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

自从：

1.2

参见：

• RootPaneContainer

内部类总结

内部类

修饰符和类型	类	描述
protected class	JApplet.AccessibleJApplet	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 此类实现了对 JApplet 类的辅助功能支持。

在类 java.applet.Applet 中声明的嵌套类/接口

Applet.AccessibleApplet

在类 java.awt.Panel 中声明的嵌套类/接口

Panel.AccessibleAWTPanel

在类 java.awt.Container 中声明的嵌套类/接口

Container.AccessibleAWTContainer

在类 java.awt.Component 中声明的嵌套类/接口

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

字段摘要

字段

修饰符和类型	Field	描述
protected AccessibleContext	accessibleContext	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 AccessibleContext 与此关联 JApplet
protected JRootPane	rootPane	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 管理 contentPane 的 JRootPane 实例。
protected boolean	rootPaneCheckingEnabled	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 如果为真，则对 add 和 setLayout 的调用将被转发到 contentPane。

在类 java.awt.Component 中声明的字段

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

在接口 java.awt.image.ImageObserver 中声明的字段

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法总结

构造方法

构造方法	描述
JApplet()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 创建一个摆动小程序实例。

方法总结

修饰符和类型	方法	描述
protected void	addImpl(Component comp, Object constraints, int index)	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 添加指定的孩子 Component 。
protected JRootPane	createRootPane()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 由构造方法调用以创建默认的 rootPane。
AccessibleContext	getAccessibleContext()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 获取与此 JApplet 关联的 AccessibleContext。
Container	getContentPane()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 返回此小程序的 contentPane 对象。
Component	getGlassPane()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 返回此小程序的 glassPane 对象。
Graphics	getGraphics()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 为此组件创建图形上下文。
JMenuBar	getJMenuBar()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 返回在此小程序上设置的菜单栏。
JLayeredPane	getLayeredPane()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 返回此小程序的 layeredPane 对象。
JRootPane	getRootPane()	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 返回此小程序的 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 元素可能会在未来版本中删除。 设置此小程序的菜单栏。
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) 。

在类 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

在类 java.awt.Panel 中声明的方法

addNotify

在类 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

在类 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

在类 java.lang.Object 中声明的方法

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

字段详细信息

rootPane

protected JRootPane  rootPane
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

管理 contentPane 的 JRootPane 实例。

参见：

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

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

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

参见：

• isRootPaneCheckingEnabled()
• setRootPaneCheckingEnabled(boolean)
• RootPaneContainer

accessibleContext

protected AccessibleContext  accessibleContext
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

AccessibleContext 与此关联 JApplet

构造方法详细信息

JApplet

public JApplet() throws HeadlessException 
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

创建一个摆动小程序实例。

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

抛出：

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

参见：

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

方法详情

createRootPane

protected JRootPane  createRootPane()
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

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

返回：

一个新的JRootPane

setTransferHandler

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

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

设置 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()
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

获取 transferHandler 属性。

返回：

transferHandler 属性的值

自从：

1.6

参见：

• TransferHandler
• setTransferHandler(javax.swing.TransferHandler)

update

public void update(Graphics  g)
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

只需调用 paint(g) 。重写此方法以防止不必要的调用来清除背景。

重写：

update 在类 Container 中

参数：

g - 指定的图形窗口

参见：

• Component.update(Graphics)

setJMenuBar

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

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

设置此小程序的菜单栏。

参数：

menuBar - 菜单栏被放置在小程序中

参见：

• getJMenuBar()

getJMenuBar

public JMenuBar  getJMenuBar()
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

返回在此小程序上设置的菜单栏。

返回：

在此小程序上设置的菜单栏

参见：

• setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

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

返回：

如果 add 和 setLayout 被转发则为真；否则为假

参见：

• 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)
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

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

参数：

enabled - 如果转发 add 和 setLayout 则为真，如果它们应直接在 JApplet 上操作则为假。

参见：

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

addImpl

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

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

添加指定的孩子 Component 。此方法被覆盖以有条件地将调用转发给 contentPane 。默认情况下，孩子被添加到 contentPane 而不是框架，有关详细信息，请参阅 RootPaneContainer 。

重写：

addImpl 在类 Container 中

参数：

comp - 要增强的组件

constraints - 要遵守的约束

index - 索引

抛出：

IllegalArgumentException - 如果 index 无效

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

IllegalArgumentException - 如果向容器添加窗口

参见：

• setRootPaneCheckingEnabled(boolean)
• RootPaneContainer

remove

public void remove(Component  comp)
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

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

重写：

remove 在类 Container 中

参数：

comp - 要删除的组件

抛出：

NullPointerException - 如果 comp 为空

参见：

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

setLayout

public void setLayout(LayoutManager  manager)
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

设置 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()
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

返回此小程序的 rootPane 对象。

指定者：

getRootPane 在接口 RootPaneContainer 中

返回：

此组件是单个 JRootPane 子组件。

参见：

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

setRootPane

protected void setRootPane(JRootPane  root)
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

设置 rootPane 属性。该方法由构造方法调用。

参数：

root - 此小程序的 rootPane 对象

参见：

• getRootPane()

getContentPane

public Container  getContentPane()
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

返回此小程序的 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)
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

设置 contentPane 属性。该方法由构造方法调用。

指定者：

setContentPane 在接口 RootPaneContainer 中

参数：

contentPane - 此小程序的 contentPane 对象

抛出：

IllegalComponentStateException -（运行时异常）如果内容窗格参数为空

参见：

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

getLayeredPane

public JLayeredPane  getLayeredPane()
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

返回此小程序的 layeredPane 对象。

指定者：

getLayeredPane 在接口 RootPaneContainer 中

返回：

layeredPane 属性的值。

抛出：

IllegalComponentStateException -（运行时异常）如果分层窗格参数为空

参见：

• 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)
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

设置 layeredPane 属性。该方法由构造方法调用。

指定者：

setLayeredPane 在接口 RootPaneContainer 中

参数：

layeredPane - 此小程序的 layeredPane 对象

参见：

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

getGlassPane

public Component  getGlassPane()
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

返回此小程序的 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)
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

设置 glassPane 属性。该方法由构造方法调用。

指定者：

setGlassPane 在接口 RootPaneContainer 中

参数：

glassPane - 此小程序的 glassPane 对象

参见：

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

getGraphics

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

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

为此组件创建图形上下文。如果此组件当前不可显示，此方法将返回 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)
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

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

重写：

repaint 在类 Component 中

参数：

time - 更新前的最长时间（以毫秒为单位）

x - 的x协调

y - 的y协调

width - 宽度

height - 高度

自从：

1.6

参见：

• RepaintManager

paramString

protected String  paramString()
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

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

重写：

paramString 在类 Container 中

返回：

此 JApplet 的字符串表示形式。

getAccessibleContext

public AccessibleContext  getAccessibleContext()
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

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

指定者：

getAccessibleContext 在接口 Accessible 中

重写：

getAccessibleContext 在类 Applet 中

返回：

作为此 JApplet 的 AccessibleContext 的 AccessibleJApplet