Module  java.desktop
软件包  java.applet

Class Applet

    • 构造方法详细信息

      • Applet

        public Applet​()
       throws HeadlessException
        已过时。
        构建一个新的Applet。

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

        异常
        HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true。
        从以下版本开始：
        1.4
        另请参见：
        GraphicsEnvironment.isHeadless()

    • 方法详细信息

      • setStub

        public final void setStub​(AppletStub stub)
        已过时。
        设置这个小程序的存根。 这是由系统自动完成的。

        如果有一个安全管理器，它的checkPermission方法被调用具有AWTPermission("setAppletStub")权限，如果存根已经被设置。

        参数
        stub - 新的存根。
        异常
        SecurityException - 如果调用者不能设置存根

      • isActive

        public boolean isActive​()
        已过时。
        确定此applet是否处于活动状态。 在调用其start方法之前，小程序被标记为活动。 在调用其stop方法之前，它变为非活动状态。
        结果
        true如果小程序是活动的; 否则为false 。
        另请参见：
        start() ， stop()

      • getDocumentBase

        public URL getDocumentBase​()
        已过时。
        获取嵌入此小程序的文档的URL。 例如，假设一个小程序包含在文档中： 
            http://www.oracle.com/technetwork/java/index.html
        文件基础是： 
            http://www.oracle.com/technetwork/java/index.html
        结果
        包含该小程序的文档的URL 。
        另请参见：
        getCodeBase()

      • getCodeBase

        public URL getCodeBase​()
        已过时。
        获取基本URL。 这是包含该小程序的目录的URL。
        结果
        包含该小程序的目录的基座URL 。
        另请参见：
        getDocumentBase()

      • getParameter

        public String getParameter​(String name)
        已过时。
        返回HTML标签中命名参数的值。 例如，如果这个小程序被指定为 
         <applet code="Clock" width=50 height=50>
 <param name=Color value="blue">
 </applet>

        那么拨打getParameter("Color")返回值为"blue" 。

        name参数不区分大小写。

        参数
        name - 参数名称。
        结果
        命名参数的值，如果没有设置， null 。

      • getAppletContext

        public AppletContext getAppletContext​()
        已过时。
        确定这个小程序的上下文，这允许小程序查询并影响它运行的环境。

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

        结果
        小程序的上下文。

      • resize

        public void resize​(int width,
                   int height)
        已过时。
        请求这个小程序调整大小。
        重写：
        resize在 Component
        参数
        width - 小程序的新请求宽度。
        height - 小程序的新请求高度。

      • resize

        public void resize​(Dimension d)
        已过时。
        请求这个小程序调整大小。
        重写：
        resize在 Component
        参数
        d - 一个给出新的宽度和高度的对象。

      • isValidateRoot

        public boolean isValidateRoot​()
        已过时。
        指示此容器是否为验证根。

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

        重写：
        isValidateRoot在 Container
        结果
        true
        从以下版本开始：
        1.7
        另请参见：
        Container.isValidateRoot()

      • showStatus

        public void showStatus​(String msg)
        已过时。
        请求参数字符串显示在“状态窗口”中。 许多浏览器和小程序查看器提供了这样的窗口，应用程序可以向用户通知其当前状态。
        参数
        msg - 在状态窗口中显示的字符串。

      • getImage

        public Image getImage​(URL url)
        已过时。
        返回一个Image对象，然后可以在屏幕上绘制。 作为参数传递的url必须指定绝对URL。

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

        参数
        url - 给出图像位置的绝对URL。
        结果
        指定网址上的图片。
        另请参见：
        Image

      • getImage

        public Image getImage​(URL url,
                      String name)
        已过时。
        返回一个Image对象，然后可以在屏幕上绘制。 url参数必须指定绝对URL。 name参数是一个相对于url参数的说明url 。

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

        参数
        url - 给出图像基本位置的绝对URL。
        name - 图像的位置，相对于 url参数。
        结果
        指定网址上的图片。
        另请参见：
        Image

      • newAudioClip

        public static final AudioClip newAudioClip​(URL url)
        已过时。
        从给定的URL获取音频剪辑。
        参数
        url - 指向音频剪辑
        结果
        音频剪辑在指定的URL。
        从以下版本开始：
        1.2

      • getAudioClip

        public AudioClip getAudioClip​(URL url)
        已过时。
        返回由URL参数指定的AudioClip对象。

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

        参数
        url - 给出音频剪辑位置的绝对URL。
        结果
        音频剪辑在指定的URL。
        另请参见：
        AudioClip

      • getAudioClip

        public AudioClip getAudioClip​(URL url,
                              String name)
        已过时。
        返回由URL和name参数指定的AudioClip对象。

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

        参数
        url - 给出音频剪辑的基本位置的绝对URL。
        name - 音频剪辑的位置，相对于 url参数。
        结果
        音频剪辑在指定的URL。
        另请参见：
        AudioClip

      • getAppletInfo

        public String getAppletInfo​()
        已过时。
        返回有关此小程序的信息。 小程序应该覆盖此方法以返回包含关于小程序的作者，版本和版权的信息的String 。

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

        结果
        一个字符串，包含有关该小程序的作者，版本和版权的信息。

      • getLocale

        public Locale getLocale​()
        已过时。
        获取小程序的区域设置。 它允许小程序保持与浏览器或appletviewer的区域设置分离的自己的区域设置。
        重写：
        getLocale在 Component
        结果
        小程序的区域; 如果没有设置语言环境，则返回默认语言环境。
        从以下版本开始：
        1.1
        另请参见：
        Component.setLocale(java.util.Locale)

      • getParameterInfo

        public String[][] getParameterInfo​()
        已过时。
        返回有关此applet可以理解的参数的信息。 一个applet应该覆盖这个方法来返回一个Strings描述这些参数的数组。

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

         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)
        已过时。
        以指定的绝对URL播放音频剪辑。 没有发现音频片段无法找到。
        参数
        url - 给出音频剪辑位置的绝对URL。

      • play

        public void play​(URL url,
                 String name)
        已过时。
        播放给定URL的音频剪辑和与之相关的说明符。 没有发现音频片段无法找到。
        参数
        url - 给出音频剪辑的基本位置的绝对URL。
        name - 音频剪辑的位置，相对于 url参数。

      • init

        public void init​()
        已过时。
        由浏览器或小程序查看器调用以通知此小程序已将其加载到系统中。 在第一次调用start方法之前总是调用它。

        Applet的子类如果具有初始化要执行， Applet应该覆盖此方法。 例如，具有线程的小程序将使用init方法来创建线程和destroy方法来杀死它们。

        由Applet类提供的这种方法的实现什么都不做。

        另请参见：
        destroy() ， start() ， stop()

      • start

        public void start​()
        已过时。
        由浏览器或小程序查看器调用，通知该小程序应该开始执行。 它是在init方法之后调用的，每次在网页中重新访问applet。

        如果Applet的子类在每次访问包含它的网页时都需要执行任何操作，则应重写此方法。 例如，具有动画的小程序可能想要使用start方法来恢复动画，而stop方法可能会暂停动画。

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

        由Applet类提供的这种方法的实现什么都不做。

        另请参见：
        destroy() ， init() ， stop() ， Component.isShowing() ， ComponentListener.componentShown(java.awt.event.ComponentEvent)

      • stop

        public void stop​()
        已过时。
        由浏览器或小程序查看器调用，通知该小程序应该停止其执行。 当包含该小程序的网页已被另一个页面替换时，也就是在小程序被销毁之前被调用。

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

        由Applet类提供的这种方法的实现什么都不做。

        另请参见：
        destroy() ， init()

      • destroy

        public void destroy​()
        已过时。
        由浏览器或小程序查看器调用以通知此小程序它正在被回收，并且它应该销毁其分配的任何资源。 stop方法将始终在destroy之前destroy 。

        如果Applet的子类在它被破坏之前要执行任何操作，应该覆盖此方法。 例如，具有线程的小程序将使用init方法来创建线程和destroy方法来杀死它们。

        由Applet类提供的这种方法的实现什么都不做。

        另请参见：
        init() ， start() ， stop()

      • getAccessibleContext

        public AccessibleContext getAccessibleContext​()
        已过时。
        获取与此Applet关联的AccessibleContext。 对于applet，AccessibleContext采用AccessibleApplet的形式。 如有必要，将创建一个新的AccessibleApplet实例。
        Specified by:
        getAccessibleContext在接口 Accessible
        重写：
        getAccessibleContext在 Panel
        结果
        一个AccessibleApplet，作为这个Applet的AccessibleContext
        从以下版本开始：
        1.3