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

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