java.applet
類別 Applet

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Panel
              java.applet.Applet

所有已實作的介面：

ImageObserver, MenuContainer, Serializable, Accessible

直接已知子類別：

JApplet

public class Applet
extends Panel

applet 是一種不能單獨運行但可嵌入在其他應用程序中的小程序。

Applet 類別必須是任何嵌入 Web 頁或可用 Java Applet Viewer 查看的 applet 的父級類別。Applet 類別提供了 applet 及其運行環境之間的標準介面。

從以下版本開始：

JDK1.0

另請參見：

序列化表格

巢狀類別摘要

protected class

Applet.AccessibleApplet 此類別實作對 Applet 類別的可存取性支持。

從類別 java.awt.Panel 繼承的巢狀類別/介面

Panel.AccessibleAWTPanel

從類別 java.awt.Container 繼承的巢狀類別/介面

Container.AccessibleAWTContainer

從類別 java.awt.Component 繼承的巢狀類別/介面

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

欄位摘要

從類別 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

建構子摘要

Applet()
建構一個新 Applet。

方法摘要

void	destroy() 由瀏覽器或 applet viewer 調用，通知此 applet 它正在被回收，它應該銷毀分派給它的任何資源。
AccessibleContext	getAccessibleContext() 獲取與此 Applet 關聯的 AccessibleContext。
AppletContext	getAppletContext() 確定此 applet 的上下文，上下文允許 applet 查詢和影響它所運行的環境。
String	getAppletInfo() 返回有關此 applet 的資訊。
AudioClip	getAudioClip(URL url) 返回 URL 參數指定的 AudioClip 物件。
AudioClip	getAudioClip(URL url, String name) 返回 URL 和 name 參數指定的 AudioClip 物件。
URL	getCodeBase() 獲得基 URL。
URL	getDocumentBase() 獲取嵌入此 applet 的文檔的 URL。
Image	getImage(URL url) 返回能被繪製到螢幕上的 Image 物件。
Image	getImage(URL url, String name) 返回能被繪製到螢幕上的 Image 物件。
Locale	getLocale() 獲取 applet 的語言環境。
String	getParameter(String name) 返回 HTML 標記中指定參數的值。
String[][]	getParameterInfo() 返回此 applet 理解的關於參數的資訊。
void	init() 由瀏覽器或 applet viewer 調用，通知此 applet 它已經被載入到系統中。
boolean	isActive() 確定 applet 是否處於活動狀態。
static AudioClip	newAudioClip(URL url) 從給定 URL 處獲取音頻剪輯。
void	play(URL url) 播放指定絕對 URL 處的音頻剪輯。
void	play(URL url, String name) 播放音頻剪輯，給定了 URL 及與之相對的說明符。
void	resize(Dimension d) 請求調整此 applet 的大小。
void	resize(int width, int height) 請求調整此 applet 的大小。
void	setStub(AppletStub stub) 設置此 applet 的 stub。
void	showStatus(String msg) 請求將參數字元串顯示在「狀態視窗」中。
void	start() 由瀏覽器或 applet viewer 調用，通知此 applet 它應該開始執行。
void	stop() 由瀏覽器或 applet viewer 調用，通知此 applet 它應該終止執行。

從類別 java.awt.Panel 繼承的方法

addNotify

從類別 java.awt.Container 繼承的方法

add, add, add, add, add, addContainerListener, addImpl, 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, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, 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, getGraphics, 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, 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

建構子詳細資訊

Applet

public Applet()
       throws HeadlessException

建構一個新 Applet。

註：java.applet.Applet 中的許多方法只有在完全建構了 applet 之後才能由該 applet 調用；在建構子中，applet 應該避免調用 java.applet.Applet 中的方法。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

從以下版本開始：

1.4

另請參見：

GraphicsEnvironment.isHeadless()

方法詳細資訊

setStub

public final void setStub(AppletStub stub)

設置此 applet 的 stub。此操作可以通過系統自動完成。

如果存在安全管理器並且設置了 stub，則通過 AWTPermission("setAppletStub") 權限調用它的 checkPermission 方法。

參數：

stub - 新 stub。

拋出：

SecurityException - 如果調用者不能設置 stub

isActive

public boolean isActive()

確定 applet 是否處於活動狀態。在調用 applet 的 start 方法之前，applet 被標記為活動狀態。在調用 applet 的 stop 方法之前，applet 被標記為非活動狀態。

返回：

如果 applet 處於活動狀態，則返回 true；否則返回 false。

另請參見：

start(), stop()

getDocumentBase

public URL getDocumentBase()

獲取嵌入此 applet 的文檔的 URL。例如，假定 applet 套件含在以下文檔中:

    http://java.sun.com/products/jdk/1.2/index.html
 

則文檔基為:

    http://java.sun.com/products/jdk/1.2/index.html
 

返回：

包含此 applet 的文檔的 URL。

另請參見：

getCodeBase()

getCodeBase

public URL getCodeBase()

獲得基 URL。這是包含此 applet 的目錄的 URL。

返回：

包含此 applet 的目錄的基 URL。

另請參見：

getDocumentBase()

getParameter

public String getParameter(String name)

返回 HTML 標記中指定參數的值。例如，如果此 applet 被指定為:

 <applet code="Clock" width=50 height=50>
 <param name=Color value="blue">
 </applet>
 

那麼調用 getParameter("Color") 將返回值 "blue"。

name 參數不區分大小寫。

參數：

name - 參數名稱。

返回：

指定參數的值；如果未設置，則返回 null。

getAppletContext

public AppletContext getAppletContext()

確定此 applet 的上下文，上下文允許 applet 查詢和影響它所運行的環境。

applet 的環境指包含該 applet 的文檔。

返回：

applet 的上下文。

resize

public void resize(int width,
                   int height)

請求調整此 applet 的大小。

覆寫：

類別 Component 中的 resize

參數：

width - 為 applet 請求的新寬度。

height - 為 applet 請求的新高度。

resize

public void resize(Dimension d)

請求調整此 applet 的大小。

覆寫：

類別 Component 中的 resize

參數：

d - 給出新寬度和高度的物件。

showStatus

public void showStatus(String msg)

請求將參數字元串顯示在「狀態視窗」中。很多瀏覽器和 applet viewer 提供這種視窗，應用程序可以通過該視窗將其當前狀態通知給使用者。

參數：

msg - 在狀態視窗中顯示的字元串。

getImage

public Image getImage(URL url)

返回能被繪製到螢幕上的 Image 物件。作為參數傳遞的 url 必須指定絕對 URL。

不管圖像存在與否，此方法總是立刻返回。當此 applet 試圖在螢幕上繪製圖像時，資料將被載入。繪製圖像的圖形圖元將逐漸繪製到螢幕上。

參數：

url - 給出圖像位置的絕對 URL。

返回：

指定 URL 處的圖像。

另請參見：

Image

getImage

public Image getImage(URL url,
                      String name)

返回能被繪製到螢幕上的 Image 物件。url 參數必須指定絕對 URL。name 參數是相對於 url 參數的說明符。

不管圖像存在與否，此方法總是立刻返回。當此 applet 試圖在螢幕上繪製圖像時，資料將被載入。繪製圖像的圖形圖元將逐漸繪製到螢幕上。

參數：

url - 給出圖像基本位置的絕對 URL。

name - 相對於 url 參數的圖像位置。

返回：

指定 URL 處的圖像。

另請參見：

Image

newAudioClip

public static final AudioClip newAudioClip(URL url)

從給定 URL 處獲取音頻剪輯。

參數：

url - 指向音頻剪輯

返回：

指定 URL 處的音頻剪輯。

從以下版本開始：

1.2

getAudioClip

public AudioClip getAudioClip(URL url)

返回 URL 參數指定的 AudioClip 物件。

不管音頻剪輯存在與否，此方法總是立即返回。當此 applet 試圖播放音頻剪輯時，資料將被載入。

參數：

url - 給出音頻剪輯位置的絕對 URL。

返回：

指定 URL 處的音頻剪輯。

另請參見：

AudioClip

getAudioClip

public AudioClip getAudioClip(URL url,
                              String name)

返回 URL 和 name 參數指定的 AudioClip 物件。

不管音頻剪輯存在與否，此方法總是立即返回。當此 applet 試圖播放音頻剪輯時，資料將被載入。

參數：

url - 給定音頻剪輯基本位置的絕對 URL。

name - 相對於 url 參數的音頻剪輯位置。

返回：

指定 URL 處的音頻剪輯。

另請參見：

AudioClip

getAppletInfo

public String getAppletInfo()

返回有關此 applet 的資訊。applet 應該覆寫此方法，返回包含有關 applet 的作者、版本和版權資訊的 String。

Applet 類別提供的此方法實作返回 null。

返回：

包含有關 applet 的作者、版本和版權資訊的字元串。

getLocale

public Locale getLocale()

獲取 applet 的語言環境。該方法允許 applet 維護自己的語言環境，該環境與瀏覽器或 appletviewer 的語言環境是分離的。

覆寫：

類別 Component 中的 getLocale

返回：

applet 的語言環境；如果尚未設置該語言環境，則返回預設語言環境。

從以下版本開始：

JDK1.1

另請參見：

Component.setLocale(java.util.Locale)

getParameterInfo

public String[][] getParameterInfo()

返回此 applet 理解的關於參數的資訊。applet 應該覆寫此方法，返回描述這些參數的 String 陣列。

陣列的每個元素應該是三個 String 的集合，包括名稱、型別和描述。例如：

 String pinfo[][] = {
         {"fps",    "1-10",    "frames per second"},
         {"repeat", "boolean", "repeat image loop"},
         {"imgs",   "url",     "images directory"}
 };
 

Applet 類別提供的此方法實作返回 null。

返回：

描述此 applet 所尋找的參數的陣列。

play

public void play(URL url)

播放指定絕對 URL 處的音頻剪輯。如果未找到音頻剪輯，則沒有任何效果。

參數：

url - 給出音頻剪輯位置的絕對 URL。

play

public void play(URL url,
                 String name)

播放音頻剪輯，給定了 URL 及與之相對的說明符。如果未找到音頻剪輯，則沒有任何效果。

參數：

url - 給定音頻剪輯基位置的絕對 URL。

name - 相對於 url 參數的音頻剪輯位置。

init

public void init()

由瀏覽器或 applet viewer 調用，通知此 applet 它已經被載入到系統中。它經常在第一次調用 start 方法前被調用。

如果 Applet 的子類別要執行初始化，則應該覆寫此方法。例如，使用執行緒的 applet 將用 init 方法創建執行緒，用 destroy 方法銷毀它們。

Applet 類別提供的此方法實作不執行任何操作。

另請參見：

destroy(), start(), stop()

start

public void start()

由瀏覽器或 applet viewer 調用，通知此 applet 它應該開始執行。它在 init 方法調用後以及在 Web 頁中每次重新存取 applet 時調用。

如果 Applet 子類別在包含它的 Web 頁被存取時有想要執行的操作，則它應該覆寫此方法。例如，帶有動畫的 applet 可能想使用 start 方法再次播放動畫，使用 stop 方法掛起動畫。

註：某些方法（如 getLocationOnScreen）只有在如果 applet 正在顯示時，才能提供有意義的結果。因為當 applet 的 start 方法第一次被調用時，isShowing 返回 false，所以需要 isShowing 返回 true 的方法應該從 ComponentListener 進行調用。

Applet 類別提供的此方法實作不執行任何操作。

另請參見：

destroy(), init(), stop(), Component.isShowing(), ComponentListener.componentShown(java.awt.event.ComponentEvent)

stop

public void stop()

由瀏覽器或 applet viewer 調用，通知此 applet 它應該終止執行。當包含此 applet 的 Web 頁已經被其他頁替換時，在 applet 被銷毀前調用此方法。

如果 Applet 子類別在包含它的 Web 頁每次不可見時有想要執行的操作，則它應該覆寫此方法。例如，帶有動畫的 applet 可能想使用 start 方法再次播放動畫，使用 stop 方法掛起動畫。

Applet 類別提供的此方法實作不執行任何操作。

另請參見：

destroy(), init()

destroy

public void destroy()

由瀏覽器或 applet viewer 調用，通知此 applet 它正在被回收，它應該銷毀分派給它的任何資源。stop 方法總是在 destroy 之前被調用。

如果 Applet 子類別在被銷毀前有想要執行的操作，則它應該覆寫此方法。例如，使用執行緒的 applet 將用 init 方法來創建執行緒，用 destroy 方法銷毀它們。

Applet 類別提供的此方法實作不執行任何操作。

另請參見：

init(), start(), stop()

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲取與此 Applet 關聯的 AccessibleContext。對於 applet，AccessibleContext 採用 AccessibleApplet 的形式。如有必要，可創建一個新的 AccessibleApplet 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

覆寫：

類別 Panel 中的 getAccessibleContext

返回：

一個 AccessibleApplet，它充當此 Applet 的 AccessibleContext

從以下版本開始：

1.3