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) 使用给定 URL 取代当前正被查看的 Web 页。
void	showDocument(URL url, String target) 请求浏览器或 applet viewer 显示由 url 参数所指示的 Web 页。
void	showStatus(String status) 请求参数字符串显示在 "status window" 中。

方法详细信息

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)

使用给定 URL 取代当前正被查看的 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)

请求参数字符串显示在 "status window" 中。很多浏览器和 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