JavaTM Platform
Standard Ed. 6

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

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策