模块  java.desktop
软件包  java.applet

Class Applet

  • 实现的所有接口
    ImageObserver ， MenuContainer ， Serializable ， Accessible
    已知直接子类：
    JApplet 
    @Deprecated(since="9")
public class Applet
extends Panel
    Deprecated.
    The Applet API is deprecated, no replacement.
    applet是一个小程序，不打算单独运行，而是嵌入到另一个应用程序中。

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

    从以下版本开始：
    1.0
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • Applet

        public Applet()
       throws HeadlessException
        Deprecated.
        构造一个新的Applet。

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

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

    • 方法详细信息

      • setStub

        public final void setStub​(AppletStub stub)
        Deprecated.
        设置此applet的存根。 这是由系统自动完成的。

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

        参数
        stub - 新存根。
        异常
        SecurityException - 如果调用者无法设置存根

      • isActive

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

      • getDocumentBase

        public URL getDocumentBase()
        Deprecated.
        获取嵌入此applet的文档的URL。 例如，假设applet包含在文档中： 
            http://www.oracle.com/technetwork/java/index.html
        文件库是： 
            http://www.oracle.com/technetwork/java/index.html
        结果
        包含此applet的文档的URL 。
        另请参见：
        getCodeBase()

      • getCodeBase

        public URL getCodeBase()
        Deprecated.
        获取基本URL。 这是包含此applet的目录的URL。
        结果
        包含此applet的目录的基础URL 。
        另请参见：
        getDocumentBase()

      • getParameter

        public String getParameter​(String name)
        Deprecated.
        返回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.
        确定此applet的上下文，它允许applet查询并影响它运行的环境。

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

        结果
        小程序的上下文。

      • resize

        public void resize​(int width,
                   int height)
        Deprecated.
        请求调整此applet的大小。
        重写：
        resize在 Component类
        参数
        width - 小程序的新请求宽度。
        height - 小程序的新请求高度。

      • resize

        public void resize​(Dimension d)
        Deprecated.
        请求调整此applet的大小。
        重写：
        resize在 Component类
        参数
        d - 提供新宽度和高度的对象。

      • isValidateRoot

        public boolean isValidateRoot()
        Deprecated.
        指示此容器是否为验证根。

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

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

      • showStatus

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

      • getImage

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

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

        参数
        url - 提供图像位置的绝对URL。
        结果
        指定URL处的图像。
        另请参见：
        Image

      • getImage

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

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

        参数
        url - 提供图像基本位置的绝对URL。
        name - 相对于 url参数的图像位置。
        结果
        指定URL处的图像。
        另请参见：
        Image

      • newAudioClip

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

      • getAudioClip

        public AudioClip getAudioClip​(URL url)
        Deprecated.
        返回URL参数指定的AudioClip对象。

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

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

      • getAudioClip

        public AudioClip getAudioClip​(URL url,
                              String name)
        Deprecated.
        返回URL和name参数指定的AudioClip对象。

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

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

      • getAppletInfo

        public String getAppletInfo()
        Deprecated.
        返回有关此applet的信息。 applet应覆盖此方法以返回String其中包含有关applet的作者，版本和版权的信息。

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

        结果
        包含有关applet的作者，版本和版权的信息的字符串。

      • getLocale

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

      • getParameterInfo

        public String[][] getParameterInfo()
        Deprecated.
        返回有关此applet可以理解的参数的信息。 applet应重写此方法以返回描述这些参数的Strings数组。

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

         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)
        Deprecated.
        以指定的绝对URL播放音频剪辑。 如果找不到音频剪辑，则没有任何反应。
        参数
        url - 提供音频剪辑位置的绝对URL。

      • play

        public void play​(URL url,
                 String name)
        Deprecated.
        播放给定URL的音频剪辑和相对于它的说明符。 如果找不到音频剪辑，则没有任何反应。
        参数
        url - 提供音频剪辑基本位置的绝对URL。
        name - 相对于 url参数的音频剪辑的位置。

      • init

        public void init()
        Deprecated.
        由浏览器或applet查看器调用以通知此applet已将其加载到系统中。 它始终在第一次调用start方法之前调用。

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

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

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

      • start

        public void start()
        Deprecated.
        由浏览器或applet查看器调用以通知此applet它应该开始执行。 它在init方法之后调用，并且每次在网页中重新访问applet。

        如果Applet的子类在每次访问包含它的Web页面时都要执行任何操作，则应该重写此方法。 例如，带动画的applet可能希望使用start方法恢复动画，而stop方法可以暂停动画。

        注意：某些方法（如getLocationOnScreen ）只能在显示小程序时提供有意义的结果。 由于isShowing回报false当applet的start第一次调用，需要方法isShowing返回true应该从一个名为ComponentListener 。

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

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

      • stop

        public void stop()
        Deprecated.
        由浏览器或applet查看器调用以通知此applet它应该停止执行。 当包含此applet的Web页面已被另一个页面替换时，以及在销毁applet之前调用它。

        如果Applet的子类在每次包含它的网页不再可见时都要执行任何操作，则应该重写此方法。 例如，带动画的applet可能希望使用start方法恢复动画，而stop方法可以暂停动画。

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

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

      • destroy

        public void destroy()
        Deprecated.
        由浏览器或applet查看器调用以通知此applet正在回收它并且它应该销毁它已分配的任何资源。 stop方法将始终在destroy之前destroy 。

        如果Applet的子类具有在销毁之前要执行的任何操作，则应该重写此方法。 例如，具有线程的applet将使用init方法创建线程，使用destroy方法来destroy它们。

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

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

      • getAccessibleContext

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