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组件体系结构支持。你可以找到面向任务的文档中使用 JApplet java教程，在部分 How to Make Applets。

的JApplet类与java.applet.Applet略有不符。JApplet包含JRootPane作为其唯一的孩子。的contentPane应该是所有孩子的JApplet母。为方便起见，本add，remove，和这类setLayout方法被重写，所以，他们的ContentPane委托调用相应的方法。例如，您可以将子组件添加到如下的小程序中：

添加（子）；

和孩子将被添加到 contentPane。的 contentPane永远是非 null。试图把它 null将导致 JApplet抛出一个异常。默认 contentPane将有一个 BorderLayout经理了。参考 RootPaneContainer细节添加，删除和设置一个 JApplet的 LayoutManager

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

警告： Swing是线程不安全的。更多信息见Swing's Threading Policy。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为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() 创建一个摆动小程序实例。

方法摘要

Modifier and Type	Method and Description
protected void	addImpl(Component comp, Object constraints, int index) 添加指定的孩子 Component。
protected JRootPane	createRootPane() 通过构造函数的方法来创建默认rootpane。
AccessibleContext	getAccessibleContext() 获取与此相关的accessiblecontext JApplet。
Container	getContentPane() 返回该对象的内容块的小程序。
Component	getGlassPane() 返回此Applet glasspane对象。
Graphics	getGraphics() 为该组件创建一个图形上下文。
JMenuBar	getJMenuBar() 返回设置该程序的菜单栏。
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) 设置此程序的菜单栏。
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

Field Detail

rootPane

protected JRootPane rootPane

另请参见：

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

rootPaneCheckingEnabled

protected boolean rootPaneCheckingEnabled

如果真的那么叫 add和 setLayout将被转发到 contentPane。这是最初的错误，而是被设置为true时， JApplet构造。

另请参见：

isRootPaneCheckingEnabled()， setRootPaneCheckingEnabled(boolean)， RootPaneContainer

accessibleContext

protected AccessibleContext accessibleContext

Constructor Detail

JApplet

public JApplet()
        throws HeadlessException

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

此构造函数设置组件的本地化属性返回的值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型。

请看 How to Use Drag and Drop and Data Transfer，java教程中的一部分，更多的信息。

参数

newHandler -新的 TransferHandler

从以下版本开始：

一点六

另请参见：

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

getTransferHandler

public TransferHandler getTransferHandler()

得到 transferHandler财产。

结果

该 transferHandler属性的值

从以下版本开始：

一点六

另请参见：

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)

设置此程序的菜单栏。

参数

menuBar -菜单栏放置在程序

另请参见：

getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()

返回设置该程序的菜单栏。

另请参见：

setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

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

结果

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

另请参见：

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转发真，假如果他们应该直接在 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)

添加指定的孩子 Component。重写此方法以有条件调用转发到 contentPane。默认情况下，孩子们加入代替框架 contentPane，指 RootPaneContainer详情。

重写：

addImpl 方法重写，继承类 Container

参数

comp -可以提高构件的

constraints -被尊重的约束

index -指数

异常

IllegalArgumentException -如果 index无效

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 -这个程序的rootpane对象

另请参见：

getRootPane()

getContentPane

public Container getContentPane()

返回该对象的内容块的小程序。

Specified by:

getContentPane 接口 RootPaneContainer

结果

内容块的属性值。

另请参见：

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

setContentPane

public void setContentPane(Container contentPane)

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

Specified by:

setContentPane 接口 RootPaneContainer

参数

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 -这个程序的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 -这个程序的glasspane对象

另请参见：

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

getGraphics

public Graphics getGraphics()

为该组件创建一个图形上下文。这个方法将返回 null如果该组件是目前不可。

重写：

getGraphics 方法重写，继承类 Component

结果

这一部分图形上下文，或如果它没有 null

从以下版本开始：

一点六

另请参见：

Component.paint(java.awt.Graphics)

repaint

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

重画指定矩形的这一部分在 time毫秒。参考 RepaintManager详情如何重新处理。

重写：

repaint 方法重写，继承类 Component

参数

time -毫秒最大时间更新前

x的X坐标

y的Y坐标

width -宽度

height -高度

从以下版本开始：

一点六

另请参见：

RepaintManager

paramString

protected String paramString()

返回JApplet的字符串表示。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。

重写：

paramString 方法重写，继承类 Container

结果

这个JApplet的字符串表示。

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此相关的accessiblecontext JApplet。对于japplets的accessiblecontext，需要一个accessiblejapplet形式。一个新的accessiblejapplet实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 Applet

结果

一个accessiblejapplet作为JApplet的accessiblecontext