JavaTM 2 Platform
Standard Ed. 5.0

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

JavaTM 2 Platform
Standard Ed. 5.0

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

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