模块 java.desktop
包 java.applet

类 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
已弃用，将被删除：此 API 元素可能会在未来版本中删除。
Applet API 已弃用，没有替代品。
applet 是一个小程序，其目的不是单独运行，而是嵌入到另一个应用程序中。

Applet 类必须是要嵌入网页或由 Java Applet 查看器查看的任何小程序的超类。 Applet 类提供小程序与其环境之间的标准接口。

自从：
1.0
参见：

  • 构造方法详细信息

    • Applet

      public Applet() throws HeadlessException
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      构造一个新的 Applet。

      注意：java.applet.Applet中的很多方法只有在小程序完全构建后才能被小程序调用；小程序应避免在构造函数中调用java.applet.Applet 中的方法。

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

  • 方法详情

    • setStub

      public final void setStub(AppletStub  stub)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      设置此小程序的存根。这是由系统自动完成的。

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

      参数：
      stub - 新存根
      抛出：
      SecurityException - 如果调用者不能设置存根

    • isActive

      public boolean isActive()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      确定此小程序是否处于活动状态。小程序在其 start 方法被调用之前被标记为活动。它在其 stop 方法被调用之前变为非活动状态。
      返回：
      true 如果小程序处于活动状态； false否则
      参见：

    • getDocumentBase

      public URL  getDocumentBase()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      获取嵌入此小程序的文档的 URL。例如，假设文档中包含一个小程序： 
        http://www.oracle.com/technetwork/java/index.html
      文档库是： 
        http://www.oracle.com/technetwork/java/index.html
      返回：
      包含此小程序的文档的 URL
      参见：

    • getCodeBase

      public URL  getCodeBase()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      获取基数 URL 。这是包含此小程序的目录的 URL。
      返回：
      包含此小程序的目录的基础URL
      参见：

    • getParameter

      public String  getParameter(String  name)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回 HTML 标记中指定参数的值。例如，如果此小程序指定为 
       <applet code="Clock" width=50 height=50>
 <param name=Color value="blue">
 </applet>

      然后调用 getParameter("Color") 返回值 "blue" 。

      name 参数不区分大小写。

      参数：
      name - 参数名称
      返回：
      命名参数的值，如果未设置则为 null

    • getAppletContext

      public AppletContext  getAppletContext()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      确定此 applet 的上下文，它允许 applet 查询和影响它运行的环境。

      applet 的这个环境表示包含该 applet 的文档。

      返回：
      小程序的上下文

    • resize

      public void resize(int width, int height)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      请求调整此小程序的大小。
      重写：
      resize 在类 Component 中
      参数：
      width - 小程序的新请求宽度
      height - 小程序的新请求高度

    • resize

      public void resize(Dimension  d)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      请求调整此小程序的大小。
      重写：
      resize 在类 Component 中
      参数：
      d - 提供新宽度和高度的对象

    • isValidateRoot

      public boolean isValidateRoot()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      指示此容器是否为验证根。

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

      重写：
      isValidateRoot 在类 Container 中
      返回：
      true
      自从：
      1.7
      参见：

    • showStatus

      public void showStatus(String  msg)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      请求参数字符串显示在“状态窗口”中。许多浏览器和小程序查看器都提供了这样一个窗口，应用程序可以在其中通知用户其当前状态。
      参数：
      msg - 在状态窗口中显示的字符串

    • getImage

      public Image  getImage(URL  url)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回一个可以在屏幕上绘制的 Image 对象。作为参数传递的 url 必须指定绝对值 URL。

      此方法总是立即返回，无论图像是否存在。当此小程序尝试在屏幕上绘制图像时，将加载数据。绘制图像的图形基元将逐渐在屏幕上绘制。

      参数：
      url - 绝对 URL 给出图像的位置
      返回：
      指定 URL 处的图像
      参见：

    • getImage

      public Image  getImage(URL  url, String  name)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回一个可以在屏幕上绘制的 Image 对象。 url 参数必须指定一个绝对的 URL 。 name 参数是相对于 url 参数的说明符。

      此方法总是立即返回，无论图像是否存在。当此小程序尝试在屏幕上绘制图像时，将加载数据。绘制图像的图形基元将逐渐在屏幕上绘制。

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

    • newAudioClip

      public static final AudioClip  newAudioClip(URL  url)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      从给定的 URL 获取音频剪辑。
      参数：
      url - 指向音频剪辑
      返回：
      指定 URL 处的音频剪辑
      自从：
      1.2

    • getAudioClip

      public AudioClip  getAudioClip(URL  url)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回由 URL 参数指定的 AudioClip 对象。

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

      参数：
      url - 绝对 URL 给出音频剪辑的位置
      返回：
      指定 URL 处的音频剪辑
      参见：

    • getAudioClip

      public AudioClip  getAudioClip(URL  url, String  name)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回由 URL 和 name 参数指定的 AudioClip 对象。

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

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

    • getAppletInfo

      public String  getAppletInfo()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回有关此小程序的信息。 applet 应该覆盖此方法以返回一个String，其中包含有关 applet 的作者、版本和版权的信息。

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

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

    • getLocale

      public Locale  getLocale()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      获取小程序的区域设置。它允许 applet 维护自己的locale，与浏览器或 appletviewer 的locale分开。
      重写：
      getLocale 在类 Component 中
      返回：
      小程序的locale；如果未设置locale，则返回默认locale
      自从：
      1.1
      参见：

    • getParameterInfo

      public String [][] getParameterInfo()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      返回有关此小程序理解的参数的信息。 applet 应该重写此方法以返回描述这些参数的字符串数组。

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

       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)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      在指定的绝对 URL 播放音频剪辑。如果找不到音频剪辑，则不会发生任何事情。
      参数：
      url - 绝对 URL 给出音频剪辑的位置

    • play

      public void play(URL  url, String  name)
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      播放给定 URL 和与其相关的说明符的音频剪辑。如果找不到音频剪辑，则不会发生任何事情。
      参数：
      url - 绝对 URL 给出音频剪辑的基本位置
      name - 音频剪辑的位置，相对于 url 参数

    • init

      public void init()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      由浏览器或 applet 查看器调用以通知此 applet 它已加载到系统中。它总是在第一次调用 start 方法之前被调用。

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

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

      参见：

    • start

      public void start()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      由浏览器或 applet 查看器调用以通知此 applet 它应该开始执行。它在 init 方法之后以及每次在网页中重新访问小程序时调用。

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

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

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

      参见：

    • stop

      public void stop()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      由浏览器或 applet 查看器调用以通知此 applet 它应该停止执行。当包含此 applet 的网页已被另一个页面替换时调用它，并且就在 applet 将被销毁之前调用。

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

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

      参见：

    • destroy

      public void destroy()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      由浏览器或 applet 查看器调用以通知此 applet 它正在被回收并且它应该销毁它已分配的任何资源。 stop 方法将始终在 destroy 之前被调用。

      如果 Applet 的子类在被销毁之前有任何要执行的操作，则应该覆盖此方法。例如，带有线程的小程序将使用 init 方法创建线程并使用 destroy 方法终止它们。

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

      参见：

    • getAccessibleContext

      public AccessibleContext  getAccessibleContext()
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      获取与此 Applet 关联的 AccessibleContext。对于小程序，AccessibleContext 采用 AccessibleApplet 的形式。如有必要，将创建一个新的 AccessibleApplet 实例。
      指定者：
      getAccessibleContext 在接口 Accessible 中
      重写：
      getAccessibleContext 在类 Panel 中
      返回：
      一个 AccessibleApplet 作为这个 Applet 的 AccessibleContext
      自从：
      1.3