javax.swing

Class JApplet

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Panel

java.applet.Applet

javax.swing.JApplet

All Implemented Interfaces:

ImageObserver ， MenuContainer ， Serializable ， Accessible ， RootPaneContainer

public class JApplet
extends Applet
implements Accessible, RootPaneContainer

java.applet.Applet的扩展版本增加了对JFC / Swing组件架构的支持。 您可以在Java Tutorial JApplet中找到有关使用JApplet的面向任务的文档 。

JApplet类与java.applet.Applet略有不java.applet.Applet 。 JApplet包含一个JRootPane作为其唯一的孩子。 contentPane应该是contentPane的任何孩子的JApplet 。 作为一种方便， add ， remove和setLayout这个类的方法将被覆盖，所以他们委托给相应方法的调用ContentPane 。 例如，您可以将子组件添加到小程序，如下所示：

  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开始，对所有JavaBeans的长期存储的支持已经添加到java.beans包中。 请参阅XMLEncoder 。

另请参见：

RootPaneContainer

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	JApplet.AccessibleJApplet 这个类实现了可访问性支持 JApplet类。

Nested classes/interfaces inherited from class java.applet.Applet

Applet.AccessibleApplet

Nested classes/interfaces inherited from class java.awt.Panel

Panel.AccessibleAWTPanel

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

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

Field Summary

Fields

Modifier and Type	Field and Description
protected AccessibleContext	accessibleContext
protected JRootPane	rootPane
protected boolean	rootPaneCheckingEnabled 如果为真，那么 add和 setLayout将被转发到 contentPane 。

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

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

构造方法摘要

构造方法

Constructor and Description
JApplet() 创建一个swing applet实例。

方法摘要

Modifier and Type	Method and Description
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毫秒内 time绘制该组件的 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) 。

Methods inherited from 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 inherited from class java.awt.Panel

addNotify

Methods inherited from 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 inherited from 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, 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, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

字段详细信息

rootPane

protected JRootPane rootPane

另请参见：

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

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

如果为真，那么add和setLayout将被转发到contentPane 。 这最初是假的，但是当JApplet时设置为true。

另请参见：

isRootPaneCheckingEnabled() ， setRootPaneCheckingEnabled(boolean) ， RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext

构造方法详细信息

JApplet

public JApplet()
        throws HeadlessException

创建一个swing applet实例。

这个构造函数将组件的区域属性返回的值JComponent.getDefaultLocale 。

异常

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

另请参见：

GraphicsEnvironment.isHeadless() ， JComponent.getDefaultLocale()

方法详细信息

createRootPane

protected JRootPane createRootPane()

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

setTransferHandler

public void setTransferHandler(TransferHandler newHandler)

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

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

注意：当与JApplet一起使用时， 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()

获得 transferHandler属性。

结果

的价值 transferHandler属性

从以下版本开始：

1.6

另请参见：

TransferHandler ， setTransferHandler(javax.swing.TransferHandler)

update

public void update(Graphics g)

只要打paint(g) 。 该方法被覆盖，以防止不必要的调用来清除背景。

重写：

update在 Container

参数

g - 指定的图形窗口

另请参见：

Component.update(Graphics)

setJMenuBar

public void setJMenuBar(JMenuBar menuBar)

设置这个applet的菜单。

参数

menuBar - 将菜单放在小苹果中

另请参见：

getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()

返回此applet上的菜单栏。

另请参见：

setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

返回是否向 add和 setLayout的 contentPane 。

结果

如果add和setLayout ，则为true; 否则为假

另请参见：

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

setRootPaneCheckingEnabled

protected void setRootPaneCheckingEnabled(boolean enabled)

设置是否向 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)

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

重写：

addImpl在 Container

参数

comp - 要增强的组件

constraints - 要遵守的限制

index - 指数

异常

IllegalArgumentException - 如果 index无效

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

IllegalArgumentException - 如果向 IllegalArgumentException添加窗口

另请参见：

setRootPaneCheckingEnabled(boolean) ， RootPaneContainer

remove

public void remove(Component comp)

从容器中删除指定的组件。 如果comp不是rootPane ，这将转发给contentPane 。 如果comp不是JFrame或contentPane的孩子，这将不会做任何事情。

重写：

remove在 Container

参数

comp - 要删除的组件

异常

NullPointerException - 如果 comp为空

另请参见：

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

setLayout

public void setLayout(LayoutManager manager)

设置LayoutManager 。 被覆盖以有条件地将呼叫转发到contentPane 。 请参阅RootPaneContainer以获取更多信息。

重写：

setLayout在 Container

参数

manager - LayoutManager

另请参见：

setRootPaneCheckingEnabled(boolean) ， RootPaneContainer

getRootPane

public JRootPane getRootPane()

返回此applet的rootPane对象。

Specified by:

getRootPane在接口 RootPaneContainer

结果

这个组件单JRootPane小孩。

另请参见：

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

setRootPane

protected void setRootPane(JRootPane root)

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

参数

root - 此applet的rootPane对象

另请参见：

getRootPane()

getContentPane

public Container getContentPane()

返回此applet的contentPane对象。

Specified by:

getContentPane在接口 RootPaneContainer

结果

contentPane属性的值。

另请参见：

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

setContentPane

public void setContentPane(Container contentPane)

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

Specified by:

setContentPane在接口 RootPaneContainer

参数

contentPane - 此applet的contentPane对象

异常

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

另请参见：

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

getLayeredPane

public JLayeredPane getLayeredPane()

返回此applet的layeredPane对象。

Specified by:

getLayeredPane在界面 RootPaneContainer

结果

layeredPane属性的值。

异常

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

另请参见：

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

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)

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

Specified by:

setLayeredPane在接口 RootPaneContainer

参数

layeredPane - 此applet的layeredPane对象

另请参见：

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

getGlassPane

public Component getGlassPane()

返回此applet的glassPane对象。

Specified by:

getGlassPane中的 RootPaneContainer

结果

glassPane属性的值。

另请参见：

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

setGlassPane

public void setGlassPane(Component glassPane)

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

Specified by:

setGlassPane在接口 RootPaneContainer

参数

glassPane - 此applet的glassPane对象

另请参见：

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

getGraphics

public Graphics getGraphics()

为此组件创建图形上下文。 此方法将返回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)

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

重写：

repaint在 Component

参数

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

x - x坐标

y - y坐标

width - 宽度

height - 身高

从以下版本开始：

1.6

另请参见：

RepaintManager

paramString

protected String paramString()

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

重写：

paramString在 Container

结果

这个JApplet的字符串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Specified by:

getAccessibleContext在界面 Accessible

重写：

getAccessibleContext在 Applet

结果

一个AccessibleJApplet，作为这个JApplet的AccessibleContext