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

另请参见：

序列化表格

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

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