模块 java.desktop

软件包 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")
@JavaBean(defaultProperty="JMenuBar",
          description="Swing\'s Applet subclass.")
public class JApplet
extends Applet
implements Accessible, RootPaneContainer

Deprecated.

The Applet API is deprecated, no replacement.

java.applet.Applet的扩展版本，增加了对JFC / Swing组件体系结构的支持。 您可以在Java教程的How to Make Applets部分找到有关使用JApplet的面向任务的文档。

JApplet类与java.applet.Applet略有不兼容。 JApplet包含一个JRootPane作为其独生子女。 contentPane应为contentPane的任何子女的JApplet 。 为方便起见， add remove和setLayout方法被重写，以便它们将调用委托给ContentPane的相应方法。 例如，您可以将子组件添加到applet，如下所示：

  applet.add(child); 

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

请参阅JRootPane文档的完整描述contentPane ， glassPane和layeredPane性质。

警告： Swing不是线程安全的。 有关更多信息，请参阅Swing's Threading Policy 。

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

从以下版本开始：

1.2

另请参见：

RootPaneContainer ， Serialized Form

嵌套类汇总

嵌套类

变量和类型	类	描述
protected class	JApplet.AccessibleJApplet	已过时。 此类实现 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

字段汇总

字段

变量和类型	字段	描述
protected AccessibleContext	accessibleContext	已过时。 AccessibleContext与此 JApplet相关联
protected JRootPane	rootPane	已过时。
protected boolean	rootPaneCheckingEnabled	已过时。 如果为true，则拨打 add和 setLayout电话将转发至 contentPane 。

声明的属性在类 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

构造方法摘要

构造方法

构造器	描述
JApplet()	已过时。 创建一个swing applet实例。

方法摘要

变量和类型	方法	描述
protected void	addImpl(Component comp, Object constraints, int index)	已过时。 添加指定的子项 Component 。
protected JRootPane	createRootPane()	已过时。 由构造函数方法调用以创建默认的rootPane。
AccessibleContext	getAccessibleContext()	已过时。 获取与此JApplet关联的AccessibleContext。
Container	getContentPane()	已过时。 返回此applet的contentPane对象。
Component	getGlassPane()	已过时。 返回此applet的glassPane对象。
Graphics	getGraphics()	已过时。 为此组件创建图形上下文。
JMenuBar	getJMenuBar()	已过时。 返回此applet上设置的菜单栏。
JLayeredPane	getLayeredPane()	已过时。 返回此applet的layeredPane对象。
JRootPane	getRootPane()	已过时。 返回此applet的rootPane对象。
TransferHandler	getTransferHandler()	已过时。 获取 transferHandler属性。
protected boolean	isRootPaneCheckingEnabled()	已过时。 返回对 add和 setLayout调用是否转发到 contentPane 。
protected String	paramString()	已过时。 返回此JApplet的字符串表示形式。
void	remove(Component comp)	已过时。 从容器中删除指定的组件。
void	repaint(long time, int x, int y, int width, int height)	已过时。 在 time毫秒内重新绘制此组件的指定矩形。
void	setContentPane(Container contentPane)	已过时。 设置contentPane属性。
void	setGlassPane(Component glassPane)	已过时。 设置glassPane属性。
void	setJMenuBar(JMenuBar menuBar)	已过时。 设置此applet的菜单栏。
void	setLayeredPane(JLayeredPane layeredPane)	已过时。 设置layeredPane属性。
void	setLayout(LayoutManager manager)	已过时。 设置 LayoutManager 。
protected void	setRootPane(JRootPane root)	已过时。 设置rootPane属性。
protected void	setRootPaneCheckingEnabled(boolean enabled)	已过时。 设置对 add和 setLayout调用是否转发到 contentPane 。
void	setTransferHandler(TransferHandler newHandler)	已过时。 设置 transferHandler属性，这是一种支持将数据传输到此组件的机制。
void	update(Graphics g)	已过时。 只需致电 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

Deprecated.

另请参见：

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

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

Deprecated.

如果为true，则拨打add和setLayout电话将转发至contentPane 。 这最初是假的，但是在构造JApplet时设置为true。

另请参见：

isRootPaneCheckingEnabled() ， setRootPaneCheckingEnabled(boolean) ， RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext

Deprecated.

AccessibleContext与此相关 JApplet

构造方法详细信息

JApplet

public JApplet()
        throws HeadlessException

Deprecated.

创建一个swing applet实例。

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

异常

HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true。

另请参见：

GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()

方法详细信息

createRootPane

protected JRootPane createRootPane()

Deprecated.

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

结果

一个新的 JRootPane

setTransferHandler

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

Deprecated.

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

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

注意：当与JApplet TransferHandler使用时， TransferHandler仅提供数据导入功能，因为数据导出相关方法当前键入JComponent 。

有关详细信息，请参阅“Java教程”中的 How to Use Drag and Drop and Data Transfer部分。

参数

newHandler - 新的 TransferHandler

从以下版本开始：

1.6

另请参见：

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

getTransferHandler

public TransferHandler getTransferHandler()

Deprecated.

获取 transferHandler属性。

结果

transferHandler属性的值

从以下版本开始：

1.6

另请参见：

TransferHandler ， setTransferHandler(javax.swing.TransferHandler)

update

public void update(Graphics g)

Deprecated.

只需致电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)

Deprecated.

设置此applet的菜单栏。

参数

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

另请参见：

getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()

Deprecated.

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

结果

菜单上设置了菜单栏

另请参见：

setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

Deprecated.

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

结果

如果转发add和add ， setLayout true;否则为add 。 否则是假的

另请参见：

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.

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

参数

enabled - 如果转发 add和 setLayout true，如果它们应直接在 JApplet上运行， 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)

Deprecated.

添加指定的子项Component 。 重写此方法以有条件地转发对contentPane调用。 默认情况下，子项将添加到contentPane而不是帧中，有关详细信息，请参阅RootPaneContainer 。

重写：

addImpl在 Container类中

参数

comp - 要增强的组件

constraints - 要遵守的约束

index - 该指数

异常

IllegalArgumentException - 如果 index无效

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

IllegalArgumentException - 如果向容器添加窗口

另请参见：

setRootPaneCheckingEnabled(boolean) ， RootPaneContainer

remove

public void remove(Component comp)

Deprecated.

从容器中删除指定的组件。 如果comp不是rootPane ，则会将呼叫转发至contentPane 。 如果comp不是JFrame或contentPane的子级，则contentPane 。

重写：

remove类 Container

参数

comp - 要删除的组件

异常

NullPointerException - 如果 comp为空

另请参见：

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

setLayout

public void setLayout(LayoutManager manager)

Deprecated.

设置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.

返回此applet的rootPane对象。

Specified by:

getRootPane ，接口 RootPaneContainer

结果

这个组件单个JRootPane子。

另请参见：

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

setRootPane

protected void setRootPane(JRootPane root)

Deprecated.

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

参数

root - 此applet的rootPane对象

另请参见：

getRootPane()

getContentPane

public Container getContentPane()

Deprecated.

返回此applet的contentPane对象。

Specified by:

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.

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

Specified by:

setContentPane ，接口 RootPaneContainer

参数

contentPane - 此applet的contentPane对象

异常

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

另请参见：

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

getLayeredPane

public JLayeredPane getLayeredPane()

Deprecated.

返回此applet的layeredPane对象。

Specified by:

getLayeredPane ，接口 RootPaneContainer

结果

layeredPane属性的值。

异常

IllegalComponentStateException - （运行时异常），如果分层窗格参数为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.

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

Specified by:

setLayeredPane在 RootPaneContainer

参数

layeredPane - 此applet的layeredPane对象

另请参见：

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

getGlassPane

public Component getGlassPane()

Deprecated.

返回此applet的glassPane对象。

Specified by:

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.

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

Specified by:

setGlassPane ，接口 RootPaneContainer

参数

glassPane - 此applet的glassPane对象

另请参见：

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

getGraphics

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

Deprecated.

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

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

重写：

repaint类 Component

参数

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

x - x坐标

y - y坐标

width - 宽度

height - 高度

从以下版本开始：

1.6

另请参见：

RepaintManager

paramString

protected String paramString()

Deprecated.

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

重写：

paramString在 Container类中

结果

此JApplet的字符串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

Deprecated.

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

Specified by:

getAccessibleContext在接口 Accessible

重写：

getAccessibleContext类 Applet

结果

一个AccessibleJApplet，用作此JApplet的AccessibleContext