JApplet (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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

public class JApplet
extends Applet
implements Accessible, RootPaneContainer
extends Applet
implements Accessible, RootPaneContainer

java.applet.Applet 的扩展版，它添加了对 JFC/Swing 组件架构的支持。有关使用 JApplet 的面向任务的文档，请参阅 The Java Tutorial 中的 How to Make Applets 一节。

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 文档。

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

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

另请参见：: RootPaneContainer

嵌套类摘要
`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`
`protected JRootPane`	`rootPane`
`protected boolean`	`rootPaneCheckingEnabled` 如果为 true，则对 `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()` 创建一个 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, 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, transferFocusBackward, 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, 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, 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, transferFocusUpCycle

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

如果为 true，则对 add 和 setLayout 的调用将转发给 contentPane。该值最初为 false，但在构造 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。

有关更多信息，请参阅 The Java Tutorial 中的 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)。重写此方法以防止不必要地调用清除了背景。

覆盖：: 类 Container 中的 update

参数：: g - 指定的 Graphics 窗口
另请参见：: Component.update(Graphics)

setJMenuBar

public void setJMenuBar(JMenuBar menuBar)

设置此 applet 的菜单栏。

参数：: menuBar - 将放置在 applet 中的菜单栏
另请参见：: getJMenuBar()

getJMenuBar

public JMenuBar getJMenuBar()

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

另请参见：: setJMenuBar(javax.swing.JMenuBar)

isRootPaneCheckingEnabled

protected boolean isRootPaneCheckingEnabled()

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

返回：: 如果转发 add 和 setLayout，则返回 true；否则返回 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，则该参数为 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。

覆盖：: 类 Container 中的 addImpl

参数：: comp - 要添加子组件的组件; constraints - 要遵从的约束条件; index - 索引
抛出：: IllegalArgumentException - 如果 index 无效; IllegalArgumentException - 如果将容器的父容器添加到该容器中; IllegalArgumentException - 如果将窗口添加到容器中
另请参见：: setRootPaneCheckingEnabled(boolean), RootPaneContainer

remove

public void remove(Component comp)

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

覆盖：: 类 Container 中的 remove

参数：: comp - 要移除的组件
抛出：: NullPointerException - 如果 comp 为 null
另请参见：: Container.add(java.awt.Component), RootPaneContainer

setLayout

public void setLayout(LayoutManager manager)

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

覆盖：: 类 Container 中的 setLayout

参数：: manager - LayoutManager
另请参见：: setRootPaneCheckingEnabled(boolean), RootPaneContainer

getRootPane

public JRootPane getRootPane()

返回此 applet 的 rootPane 对象。

指定者：: 接口 RootPaneContainer 中的 getRootPane

返回：: 此组件的单个 JRootPane 子组件。
另请参见：: setRootPane(javax.swing.JRootPane), RootPaneContainer.getRootPane()

setRootPane

protected void setRootPane(JRootPane root)

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

参数：: root - 此 applet 的 rootPane 对象
另请参见：: getRootPane()

getContentPane

public Container getContentPane()

返回此 applet 的 contentPane 对象。

指定者：: 接口 RootPaneContainer 中的 getContentPane

返回：: contentPane 属性的值。
另请参见：: setContentPane(java.awt.Container), RootPaneContainer.getContentPane()

setContentPane

public void setContentPane(Container contentPane)

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

指定者：: 接口 RootPaneContainer 中的 setContentPane

参数：: contentPane - 此 applet 的 contentPane 对象
抛出：: IllegalComponentStateException - （运行时异常）如果内容窗格参数为 null
另请参见：: getContentPane(), RootPaneContainer.setContentPane(java.awt.Container)

getLayeredPane

public JLayeredPane getLayeredPane()

返回此 applet 的 layeredPane 对象。

指定者：: 接口 RootPaneContainer 中的 getLayeredPane

返回：: layeredPane 属性的值。
抛出：: IllegalComponentStateException - （运行时异常）如果分层窗格参数为 null
另请参见：: setLayeredPane(javax.swing.JLayeredPane), RootPaneContainer.getLayeredPane()

setLayeredPane

public void setLayeredPane(JLayeredPane layeredPane)

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

指定者：: 接口 RootPaneContainer 中的 setLayeredPane

参数：: layeredPane - 此 applet 的 layeredPane 对象
另请参见：: getLayeredPane(), RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

getGlassPane

public Component getGlassPane()

返回此 applet 的 glassPane 对象。

指定者：: 接口 RootPaneContainer 中的 getGlassPane

返回：: glassPane 属性的值。
另请参见：: setGlassPane(java.awt.Component), RootPaneContainer.getGlassPane()

setGlassPane

public void setGlassPane(Component glassPane)

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

指定者：: 接口 RootPaneContainer 中的 setGlassPane

参数：: glassPane - 此 applet 的 glassPane 对象
另请参见：: getGlassPane(), RootPaneContainer.setGlassPane(java.awt.Component)

getGraphics

public Graphics getGraphics()

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

覆盖：: 类 Component 中的 getGraphics

返回：: 组件的图形上下文，如果其没有，则返回 null
从以下版本开始：: 1.6
另请参见：: Component.paint(java.awt.Graphics)

repaint

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

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

覆盖：: 类 Component 中的 repaint

参数：: time - 更新前等待的最长时间（以毫秒为单位）; x - x 坐标; y - y 坐标; width - 宽度; height - 高度
从以下版本开始：: 1.6
另请参见：: RepaintManager

paramString

protected String paramString()

返回此 JApplet 的字符串表示形式。此方法仅在进行调试时使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可以为空，但不可以为 null。

覆盖：: 类 Container 中的 paramString

返回：: 此 JApplet 的字符串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

指定者：: 接口 Accessible 中的 getAccessibleContext
覆盖：: 类 Applet 中的 getAccessibleContext

返回：: 一个 AccessibleJApplet，它充当此 JApplet 的 AccessibleContext

概述