java.applet
介面 AppletContext

public interface AppletContext

此介面對應於 applet 的環境：包含 applet 的文檔以及同一文檔中的其他 applet。

applet 可以使用此介面中的方法獲取有關其環境的資訊。

從以下版本開始：

JDK1.0

方法摘要

Applet	getApplet(String name) 通過給定名稱找到並返回此 applet 上下文表示的文檔中的 applet。
Enumeration<Applet>	getApplets() 找到此 applet 上下文表示的文檔中的所有 applet。
AudioClip	getAudioClip(URL url) 創建音頻剪輯。
Image	getImage(URL url) 返回能被繪製到螢幕上的 Image 物件。
InputStream	getStream(String key) 返回此 applet 上下文中指定鍵所關聯的串流。
Iterator<String>	getStreamKeys() 找到此 applet 上下文中所有串流對應的鍵。
void	setStream(String key, InputStream stream) 在此 applet 上下文中用指定的鍵關聯指定的串流。
void	showDocument(URL url) 請求瀏覽器或 applet viewer 顯示 url 參數指示的 Web 頁面。
void	showDocument(URL url, String target) 請求瀏覽器或 applet viewer 顯示由 url 參數所指示的 Web 頁。
void	showStatus(String status) 請求參數字元串顯示在「狀態視窗」中。

方法詳細資訊

getAudioClip

AudioClip getAudioClip(URL url)

創建音頻剪輯。

參數：

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

返回：

指定 URL 處的音頻剪輯。

getImage

Image getImage(URL url)

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

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

參數：

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

返回：

指定 URL 處的圖像。

另請參見：

Image

getApplet

Applet getApplet(String name)

通過給定名稱找到並返回此 applet 上下文表示的文檔中的 applet。名稱可以在 HTML 標記中通過設置 name 屬性來設置。

參數：

name - applet 名稱。

返回：

具有給定名稱的 applet；如果未找到，則返回 null。

getApplets

Enumeration<Applet> getApplets()

找到此 applet 上下文表示的文檔中的所有 applet。

返回：

此 applet 上下文表示的文檔中所有 applet 的列舉。

showDocument

void showDocument(URL url)

請求瀏覽器或 applet viewer 顯示 url 參數指示的 Web 頁面。瀏覽器或 applet viewer 確定使用哪個視窗或窗體來顯示 Web 頁面。非瀏覽器的 applet 上下文可以忽略此方法。

參數：

url - 給出文檔位置的絕對 URL。

showDocument

void showDocument(URL url,
                  String target)

請求瀏覽器或 applet viewer 顯示由 url 參數所指示的 Web 頁。target 參數指示在哪個 HTML 窗體中顯示文檔。target 參數的解釋如下:

Target 參數	描述
"_self"	在包含 applet 的視窗和窗體中顯示。
"_parent"	在 applet 的父窗體中顯示。如果 applet 的窗體沒有父窗體，執行與 "_self" 相同的動作。
"_top"	在 applet 視窗的頂層窗體中顯示。如果 applet 窗體是頂層窗體，執行與 "_self" 相同的動作。
"_blank"	在一個新的、未命名的頂層視窗中顯示。
name	在名為 name 的窗體或視窗中顯示。如果名為 name 的 target 尚未存在，將創建一個具有指定名稱的新頂層視窗，文檔將在該視窗中顯示。

applet viewer 或瀏覽器可以隨意地忽略 showDocument。

參數：

url - 給定文檔位置的絕對 URL。

target - 指示在哪裡顯示頁面的 String。

showStatus

void showStatus(String status)

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

參數：

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

setStream

void setStream(String key,
               InputStream stream)
               throws IOException

在此 applet 上下文中用指定的鍵關聯指定的串流。如果 applet 上下文以前包含了一個此鍵的映射關係，那麼將替換舊值。

出於安全性考慮，每個程式碼基都存在串流和鍵的映射。換句話說，一個程式碼基中的 applet 不能存取不同程式碼基中的 applet 創建的串流。

參數：

key - 指定值要關聯的鍵。

stream - 指定鍵要關聯的串流。如果此參數為 null，則在此 applet 上下文中將移除指定鍵。

拋出：

IOException - 如果串流大小超過了一定大小限制。大小限制由此介面的實作者確定。

IOException

從以下版本開始：

JDK1.4

getStream

InputStream getStream(String key)

返回此 applet 上下文中指定鍵所關聯的串流。如果 applet 上下文中不包含此鍵對應的串流，則返回 null。

由於安全性考慮，每個程式碼基都存在串流和鍵的映射。換句話說，一個程式碼基中的 applet 不能存取不同程式碼基中的 applet 創建的串流。

參數：

key - 要返回其關聯串流的鍵。

返回：

此 applet 上下文將鍵映射到的串流

從以下版本開始：

JDK1.4

getStreamKeys

Iterator<String> getStreamKeys()

找到此 applet 上下文中所有串流對應的鍵。

由於安全性考慮，每個程式碼基都存在串流和鍵的映射。換句話說，一個程式碼基中的 applet 不能存取不同程式碼基中的 applet 創建的串流。

返回：

返回此 applet 上下文中所有串流名稱的迭代器。

從以下版本開始：

JDK1.4