JavaTM Platform
Standard Ed. 6

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.BaselineResizeBehavior, 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)
          请求将参数字符串显示在“状态窗口”中。
 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, getBaseline, getBaselineResizeBehavior, 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。

注:java.applet.Applet 中的许多方法只有在完全构造了 applet 之后才能由该 applet 调用;在构造方法中,applet 应该避免调用 java.applet.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
 
则文档基为:
    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)
请求将参数字符串显示在“状态窗口”中。很多浏览器和 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 的语言环境。该方法允许 applet 维护自己的语言环境,该环境与浏览器或 appletviewer 的语言环境是分离的。

覆盖:
Component 中的 getLocale
返回:
applet 的语言环境;如果尚未设置该语言环境,则返回默认语言环境。
从以下版本开始:
JDK1.1
另请参见:
Component.setLocale(java.util.Locale)

getParameterInfo

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

数组的每个元素应该是三个 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 方法调用后以及在 Web 页中每次重新访问 applet 时调用。

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

注:某些方法(如 getLocationOnScreen)只有在如果 applet 正在显示时,才能提供有意义的结果。因为当 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 可能想使用 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
从以下版本开始:
1.3

JavaTM Platform
Standard Ed. 6

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

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