JavaTM 2 Platform
Standard Ed. 5.0

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
另请参见:
序列化表格

嵌套类摘要
protected  class Applet.AccessibleApplet
          此类实现对 Applet 类的可访问性支持。
 
从类 java.awt.Panel 继承的嵌套类/接口
Panel.AccessibleAWTPanel
 
从类 java.awt.Container 继承的嵌套类/接口
Container.AccessibleAWTContainer
 
从类 java.awt.Component 继承的嵌套类/接口
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
字段摘要
 
从类 java.awt.Component 继承的字段
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
从接口 java.awt.image.ImageObserver 继承的字段
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
构造方法摘要
Applet()
          创建一个新的 Applet 对象
 
方法摘要
 void destroy()
          由浏览器或 applet viewer 调用,通知此 applet 它正在被回收,它应该销毁分配给它的任何资源。
 AccessibleContext getAccessibleContext()
          获取与此 Applet 有关的 AccessibleContext。
 AppletContext getAppletContext()
          确定此 applet 的上下文,上下文允许 applet 查询和影响它所运行的环境。
 String getAppletInfo()
          返回有关此 applet 的信息。
 AudioClip getAudioClip(URL url)
          返回 URL 参数指定的 AudioClip 对象。
 AudioClip getAudioClip(URL url, String name)
          返回由参数 URLname 指定的 AudioClip 对象。
 URL getCodeBase()
          获得基 URL。
 URL getDocumentBase()
          获取嵌入了此 applet 的文档的 URL。
 Image getImage(URL url)
          返回能被绘制到屏幕上的 Image 对象。
 Image getImage(URL url, String name)
          返回能被绘制到屏幕上的 Image 对象。
 Locale getLocale()
          如果已经设置,则获取 applet 的语言环境。
 String getParameter(String name)
          返回 HTML 标记中命名参数的值。
 String[][] getParameterInfo()
          返回此 applet 理解的关于参数的信息。
 void init()
          由浏览器或 applet viewer 调用,通知此 applet 它已经加载到系统中。
 boolean isActive()
          确定 applet 是否处于激活状态。
static AudioClip newAudioClip(URL url)
          从给定 URL 处获取音频剪辑。
 void play(URL url)
          播放在指定的绝对 URL 处的音频剪辑。
 void play(URL url, String name)
          播放给定 URL 和与其相关的说明符的音频剪辑。
 void resize(Dimension d)
          请求调整此 applet 的大小。
 void resize(int width, int height)
          请求调整此 applet 的大小。
 void setStub(AppletStub stub)
          设置此 applet 的 stub。
 void showStatus(String msg)
          请求参数字符串显示在 "status window" 中。
 void start()
          由浏览器或 applet viewer 调用,通知此 applet 它应该开始执行。
 void stop()
          由浏览器或 applet viewer 调用,通知此 applet 它应该终止执行。
 
从类 java.awt.Panel 继承的方法
addNotify
 
从类 java.awt.Container 继承的方法
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree
 
从类 java.awt.Component 继承的方法
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusUpCycle
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

Applet

public Applet()
       throws HeadlessException
创建一个新的 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
 
此文档的基 URL 是:
    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)
请求参数字符串显示在 "status window" 中。很多浏览器和 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)
返回由参数 URLname 指定的 AudioClip 对象。

不管音频剪辑存在与否,此方法总是立即返回。当此 applet 试图播放音频剪辑时,数据将被加载。

参数:
url - 给定音频剪辑基本位置的绝对 URL。
name - 相对于 url 参数的音频剪辑位置。
返回:
指定 URL 处的音频剪辑。
另请参见:
AudioClip

getAppletInfo

public String getAppletInfo()
返回有关此 applet 的信息。applet 应该重写此方法,返回包含有关 applet 的作者、版本和版权信息的 String

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

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

getLocale

public Locale getLocale()
如果已经设置,则获取 applet 的语言环境。如果未设置语言环境,则返回默认的语言环境。

覆盖:
Component 中的 getLocale
返回:
applet 的语言环境
从以下版本开始:
JDK1.1
另请参见:
Component.setLocale(java.util.Locale)

getParameterInfo

public String[][] getParameterInfo()
返回此 applet 理解的关于参数的信息。applet 应该重写此方法,返回描述这些参数的 Strings 数组。

数组的每个元素应该是包含名称、类型和描述这三个 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 方法调用后和每次 applet 在 Web 页中被重新访问时调用。

每次包含 Applet 的 Web 页被访问时,如果 Applet 有想要执行的操作,则它的子类就应该重写此方法。例如,带有动画的 applet 可能想使用 start 方法来播放动画,使用 stop 方法来挂起动画。

注:如果 applet 正在显示,则某些方法(如 getLocationOnScreen)只能提供有意义的结果。因为当 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 有想要执行的操作,则它的子类就应该重写此方法。例如,带有动画的 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

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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