Module java.desktop
Package java.applet

Class Applet

java.lang.Object
java.awt.Component
java.awt.Container
java.awt.Panel
java.applet.Applet
所有已实现的接口:
ImageObserver, MenuContainer, Serializable, Accessible
直接已知的子类:
JApplet
@Deprecated(since="9", forRemoval=true) public class Applet extends Panel
Deprecated, for removal: This API element is subject to removal in a future version.
The Applet API is deprecated, no replacement.
Applet是一个小程序，旨在不单独运行，而是嵌入到另一个应用程序中。

Applet类必须是要嵌入到Web页面中或由Java Applet Viewer查看的任何applet的超类。 Applet类提供了applet与其环境之间的标准接口。

自：
1.0
参见：

  • Constructor Details

    • Applet

      public Applet() throws HeadlessException
      Deprecated, for removal: This API element is subject to removal in a future version.
      构造一个新的Applet。

      注意：在完全构造applet之后，可能只有在applet中调用java.applet.Applet中的方法；applet应避免在构造函数中调用java.applet.Applet中的方法。

      抛出:
      HeadlessException - 如果GraphicsEnvironment.isHeadless()返回true
      自：
      1.4
      参见：

  • Method Details

    • setStub

      public final void setStub(AppletStub stub)
      Deprecated, for removal: This API element is subject to removal in a future version.
      设置此applet的存根。系统会自动执行此操作。

      如果存在安全管理器，则如果已设置存根，则将调用其checkPermission方法，权限为AWTPermission("setAppletStub")。

      参数:
      stub - 新存根
      抛出:
      SecurityException - 如果调用者无法设置存根

    • isActive

      public boolean isActive()
      Deprecated, for removal: This API element is subject to removal in a future version.
      确定此applet是否处于活动状态。在调用其start方法之前，applet被标记为活动。在调用其stop方法之前，它变为非活动状态。
      返回:
      如果applet处于活动状态，则返回true；否则返回false
      参见:

    • getDocumentBase

      public URL getDocumentBase()
      Deprecated, for removal: This API element is subject to removal in a future version.
      获取包含此applet的文档的URL。例如，假设一个applet包含在文档中： 
          http://www.oracle.com/technetwork/java/index.html
      文档基础是： 
          http://www.oracle.com/technetwork/java/index.html
      返回:
      包含此applet的文档的URL
      参见:

    • getCodeBase

      public URL getCodeBase()
      Deprecated, for removal: This API element is subject to removal in a future version.
      获取基本URL。这是包含此applet的目录的URL。
      返回:
      包含此applet的目录的基本URL
      参见:

    • getParameter

      public String getParameter(String name)
      Deprecated, for removal: This API element is subject to removal in a future version.
      返回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()
      Deprecated, for removal: This API element is subject to removal in a future version.
      确定此小程序的上下文，允许小程序查询和影响其运行环境。

      小程序的环境代表包含小程序的文档。

      返回：
      小程序的上下文

    • resize

      public void resize(int width, int height)
      Deprecated, for removal: This API element is subject to removal in a future version.
      请求调整此小程序的大小。
      覆盖：
      resize 在类 Component中
      参数：
      width - 小程序的新请求宽度
      height - 小程序的新请求高度

    • resize

      public void resize(Dimension d)
      Deprecated, for removal: This API element is subject to removal in a future version.
      请求调整此小程序的大小。
      覆盖：
      resize 在类 Component中
      参数：
      d - 包含新宽度和高度的对象

    • isValidateRoot

      public boolean isValidateRoot()
      Deprecated, for removal: This API element is subject to removal in a future version.
      指示此容器是否为验证根。

      Applet对象是验证根，因此它们覆盖此方法以返回true。

      覆盖：
      isValidateRoot 在类 Container中
      返回：
      true
      自：
      1.7
      另请参阅：

    • showStatus

      public void showStatus(String msg)
      Deprecated, for removal: This API element is subject to removal in a future version.
      请求在“状态窗口”中显示参数字符串。许多浏览器和小程序查看器提供此窗口，应用程序可以在其中通知用户其当前状态。
      参数：
      msg - 要在状态窗口中显示的字符串

    • getImage

      public Image getImage(URL url)
      Deprecated, for removal: This API element is subject to removal in a future version.
      返回一个Image对象，然后可以在屏幕上绘制。传递作为参数的url必须指定绝对URL。

      此方法始终立即返回，无论图像是否存在。当此小程序尝试在屏幕上绘制图像时，数据将被加载。绘制图像的图形原语将逐步在屏幕上绘制。

      参数：
      url - 指定图像位置的绝对URL
      返回：
      指定URL处的图像
      另请参阅：

    • getImage

      public Image getImage(URL url, String name)
      Deprecated, for removal: This API element is subject to removal in a future version.
      返回一个Image对象，然后可以在屏幕上绘制。url参数必须指定绝对URL。name参数是相对于url参数的定位符。

      此方法始终立即返回，无论图像是否存在。当此小程序尝试在屏幕上绘制图像时，数据将被加载。绘制图像的图形原语将逐步在屏幕上绘制。

      参数：
      url - 指定图像基本位置的绝对URL
      name - 图像的位置，相对于url参数
      返回：
      指定URL处的图像
      另请参阅：

    • newAudioClip

      public static final AudioClip newAudioClip(URL url)
      Deprecated, for removal: This API element is subject to removal in a future version.
      从给定的URL获取音频剪辑。
      参数：
      url - 指向音频剪辑的URL
      返回：
      指定URL处的音频剪辑
      自：
      1.2

    • getAudioClip

      public AudioClip getAudioClip(URL url)
      Deprecated, for removal: This API element is subject to removal in a future version.
      返回由URL参数指定的AudioClip对象。

      此方法始终立即返回，无论音频剪辑是否存在。当此小程序尝试播放音频剪辑时，数据将被加载。

      参数：
      url - 指定音频剪辑位置的绝对URL
      返回：
      指定URL处的音频剪辑
      另请参阅：

    • getAudioClip

      public AudioClip getAudioClip(URL url, String name)
      Deprecated, for removal: This API element is subject to removal in a future version.
      返回由URL和name参数指定的AudioClip对象。

      此方法始终立即返回，无论音频剪辑是否存在。当此小程序尝试播放音频剪辑时，数据将被加载。

      参数：
      url - 指定音频剪辑基本位置的绝对URL
      name - 音频剪辑的位置，相对于url参数
      返回：
      指定URL处的音频剪辑
      另请参阅：

    • getAppletInfo

      public String getAppletInfo()
      Deprecated, for removal: This API element is subject to removal in a future version.
      返回有关此小程序的信息。小程序应覆盖此方法以返回包含有关作者、版本和版权的信息的String。

      Applet类提供的此方法的实现返回null。

      返回：
      包含有关作者、版本和版权的信息的字符串

    • getLocale

      public Locale getLocale()
      Deprecated, for removal: This API element is subject to removal in a future version.
      获取小程序的区域设置。它允许小程序保持其自己的区域设置，与浏览器或小程序查看器的区域设置分开。
      覆盖：
      getLocale 在类 Component中
      返回：
      小程序的区域设置；如果未设置区域设置，则返回默认区域设置
      自：
      1.1
      另请参阅：

    • getParameterInfo

      public String[][] getParameterInfo()
      Deprecated, for removal: This API element is subject to removal in a future version.
      返回此小程序理解的参数信息。小程序应覆盖此方法以返回描述这些参数的字符串数组。

      数组的每个元素应该是包含名称、类型和描述的三个字符串集合。例如：

       String pinfo[][] = {
   {"fps",    "1-10",    "frames per second"},
   {"repeat", "boolean", "repeat image loop"},
   {"imgs",   "url",     "images directory"}
 };

      Applet类提供的此方法的实现返回null。

      返回：
      描述此小程序寻找的参数的数组

    • play

      public void play(URL url)
      Deprecated, for removal: This API element is subject to removal in a future version.
      播放指定绝对URL处的音频剪辑。如果找不到音频剪辑，则不会发生任何事情。
      参数：
      url - 指定音频剪辑位置的绝对URL

    • play

      public void play(URL url, String name)
      Deprecated, for removal: This API element is subject to removal in a future version.
      播放给定URL和相对于其的定位符的音频剪辑。如果找不到音频剪辑，则不会发生任何事情。
      参数：
      url - 指定音频剪辑基本位置的绝对URL
      name - 音频剪辑的位置，相对于url参数

    • init

      public void init()
      Deprecated, for removal: This API element is subject to removal in a future version.
      浏览器或小程序查看器调用此方法，通知此小程序已加载到系统中。在第一次调用start方法之前始终会调用此方法。

      Applet的子类应该覆盖此方法，如果有初始化操作要执行。例如，具有线程的小程序将使用init方法创建线程，并使用destroy方法终止线程。

      Applet类提供的此方法的实现不执行任何操作。

      另请参阅：

    • start

      public void start()
      Deprecated, for removal: This API element is subject to removal in a future version.
      浏览器或小程序查看器调用此方法，通知此小程序应开始执行。在init方法之后调用，并在每次在Web页面中重新访问包含它的小程序时调用。

      Applet的子类应该覆盖此方法，如果有任何操作要在每次访问包含它的Web页面时执行。例如，具有动画的小程序可能希望使用start方法恢复动画，并使用stop方法暂停动画。

      注意：某些方法，如getLocationOnScreen，只能在小程序显示时提供有意义的结果。因为当首次调用小程序的start时，isShowing返回false，所以需要从ComponentListener中调用需要isShowing返回true的方法。

      Applet类提供的此方法的实现不执行任何操作。

      另请参阅：

    • stop

      public void stop()
      Deprecated, for removal: This API element is subject to removal in a future version.
      浏览器或小程序查看器调用此方法，通知此小程序应停止执行。当包含此小程序的Web页面被另一个页面替换时调用，也在小程序将被销毁之前调用。

      Applet的子类应该覆盖此方法，如果有任何操作要在包含它的Web页面不再可见时执行。例如，具有动画的小程序可能希望使用start方法恢复动画，并使用stop方法暂停动画。

      Applet类提供的此方法的实现不执行任何操作。

      参见：

    • destroy

      public void destroy()
      Deprecated, for removal: This API element is subject to removal in a future version.
      浏览器或小程序查看器调用此方法，通知该小程序正在被回收，并且应该销毁已分配的任何资源。在调用destroy方法之前，stop方法将始终被调用。

      Applet的子类应该在销毁之前执行任何操作的情况下重写此方法。例如，具有线程的小程序将使用init方法创建线程，并使用destroy方法终止它们。

      Applet类提供的此方法的实现不执行任何操作。

      参见：

    • getAccessibleContext

      public AccessibleContext getAccessibleContext()
      Deprecated, for removal: This API element is subject to removal in a future version.
      获取与此Applet关联的AccessibleContext。对于小程序，AccessibleContext采用AccessibleApplet的形式。如有必要，将创建一个新的AccessibleApplet实例。
      指定者：
      getAccessibleContext 在接口 Accessible
      覆盖：
      getAccessibleContext 在类 Panel
      返回：
      作为此Applet的AccessibleContext的AccessibleApplet
      自：
      1.3