java.applet

Class Applet

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Panel

java.applet.Applet

All Implemented Interfaces:

ImageObserver ， MenuContainer ， Serializable ， Accessible

已知直接子类：

JApplet

public class Applet
extends Panel

一个小程序是一个小程序，它不想独立运行，而是嵌入到另一个应用程序中。

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

从以下版本开始：

JDK1.0

另请参见：

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Applet.AccessibleApplet 这个类实现了可访问性支持 Applet类。

Nested classes/interfaces inherited from class java.awt.Panel

Panel.AccessibleAWTPanel

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法

Constructor and Description
Applet() 构建一个新的Applet。

方法摘要

Modifier and Type	Method and Description
void	destroy() 由浏览器或小程序查看器调用以通知此小程序它正在被回收，并且它应该销毁其分配的任何资源。
AccessibleContext	getAccessibleContext() 获取与此Applet关联的AccessibleContext。
AppletContext	getAppletContext() 确定这个小程序的上下文，这允许小程序查询并影响它运行的环境。
String	getAppletInfo() 返回有关此小程序的信息。
AudioClip	getAudioClip(URL url) 返回由 URL参数指定的 AudioClip对象。
AudioClip	getAudioClip(URL url, String name) 返回 URL和 name参数指定的 AudioClip对象。
URL	getCodeBase() 获取基本URL。
URL	getDocumentBase() 获取嵌入此小程序的文档的URL。
Image	getImage(URL url) 返回一个 Image对象，然后可以在屏幕上绘制。
Image	getImage(URL url, String name) 返回一个 Image对象，然后可以在屏幕上绘制。
Locale	getLocale() 获取小程序的区域设置。
String	getParameter(String name) 返回HTML标签中命名参数的值。
String[][]	getParameterInfo() 返回有关此applet可以理解的参数的信息。
void	init() 由浏览器或小程序查看器调用以通知此小程序已将其加载到系统中。
boolean	isActive() 确定此applet是否处于活动状态。
boolean	isValidateRoot() 指示此容器是否为验证根。
static AudioClip	newAudioClip(URL url) 从给定的URL获取音频剪辑。
void	play(URL url) 以指定的绝对URL播放音频剪辑。
void	play(URL url, String name) 播放给定URL的音频剪辑和与之相关的说明符。
void	resize(Dimension d) 请求这个小程序调整大小。
void	resize(int width, int height) 请求这个小程序调整大小。
void	setStub(AppletStub stub) 设置这个小程序的存根。
void	showStatus(String msg) 请求参数字符串显示在“状态窗口”中。
void	start() 由浏览器或小程序查看器调用，通知该小程序应该开始执行。
void	stop() 由浏览器或小程序查看器调用，通知该小程序应该停止其执行。

Methods inherited from class java.awt.Panel

addNotify

Methods inherited from class 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, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class 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, revalidate, 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, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

Applet

public Applet()
       throws HeadlessException

构建一个新的Applet。

注意：只有小程序完全构建后，小程序才能调用java.applet.Applet中的许多方法; applet应避免在java.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类提供的这种方法的Applet返回null 。

结果

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

getLocale

public Locale getLocale()

获取小程序的区域设置。 它允许小程序保持与浏览器或appletviewer的区域设置分离的自己的区域设置。

重写：

getLocale在类别 Component

结果

小程序的区域; 如果没有设置语言环境，则返回默认语言环境。

从以下版本开始：

JDK1.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类提供的这种方法的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的子类如果具有要执行的初始化，则应该覆盖此方法。 例如，具有线程的小程序将使用init方法创建线程和destroy方法来杀死它们。

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

另请参见：

destroy() ， start() ， stop()

start

public void start()

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

如果Applet的子类在每次访问包含该网页的任何操作时都应该覆盖此方法。 例如，具有动画的小程序可能想要使用start方法来恢复动画，以及stop方法来暂停动画。

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

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

另请参见：

destroy() ， init() ， stop() ， Component.isShowing() ， ComponentListener.componentShown(java.awt.event.ComponentEvent)

stop

public void stop()

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

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

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

另请参见：

destroy() ， init()

destroy

public void destroy()

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

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

Applet类提供的这种方法的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