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类必须是任何程序，可以嵌入在网页中的java 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() 构建一个新的小程序。

方法摘要

Modifier and Type	Method and Description
void	destroy() 由浏览器或小程序浏览器调用来通知这个小程序，它正在被回收，它应该破坏它所分配的任何资源。
AccessibleContext	getAccessibleContext() 获取与该程序相关的accessiblecontext。
AppletContext	getAppletContext() 确定这个小程序的上下文，它允许小程序查询和影响它所运行的环境。
String	getAppletInfo() 返回此小程序的信息。
AudioClip	getAudioClip(URL url) 返回由 URL参数指定的 AudioClip对象。
AudioClip	getAudioClip(URL url, String name) 返回 AudioClip对象指定的 URL和 name参数。
URL	getCodeBase() 获取基本的网址。
URL	getDocumentBase() 获取此小程序嵌入的文档的网址。
Image	getImage(URL url) 返回一个对象， Image然后可以画在屏幕上。
Image	getImage(URL url, String name) 返回一个对象， Image然后可以画在屏幕上。
Locale	getLocale() 获取小程序的区域设置。
String	getParameter(String name) 返回指定的HTML标签参数的值。
String[][]	getParameterInfo() 返回由这个小程序所理解的参数的信息。
void	init() 由浏览器或小程序浏览器调用来通知这个小程序，它已加载到系统中。
boolean	isActive() 确定这个小程序是否是有效的。
boolean	isValidateRoot() 指示此容器是否是验证根。
static AudioClip	newAudioClip(URL url) 从给定的网址获取音频剪辑。
void	play(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

Constructor Detail

Applet

public Applet()
       throws HeadlessException

构建一个新的小程序。

注：在java.applet.Applet许多方法可以调用的程序只有在程序完全构造；程序应避免在构造函数中调用方法java.applet.Applet。

异常

HeadlessException -如果graphicsenvironment isheadless()返回true。

从以下版本开始：

一点四

另请参见：

GraphicsEnvironment.isHeadless()

方法详细信息

setStub

public final void setStub(AppletStub stub)

设置这个小程序的存根。这是由系统自动完成的。

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

参数

stub -新的存根。

异常

SecurityException如果调用者不能设置存根

isActive

public boolean isActive()

确定这个小程序是否是有效的。一个applet标记活跃在 start方法称为。它成为活跃在 stop方法称为。

结果

true如果applet是积极的； false否则。

另请参见：

start()， stop()

getDocumentBase

public URL getDocumentBase()

获取此小程序嵌入的文档的网址。例如，假设一个程序内包含的文件：

    http://www.oracle.com/technetwork/java/index.html
 

文档库：

    http://www.oracle.com/technetwork/java/index.html
 

结果

这个小程序，包含文件的 URL。

另请参见：

getCodeBase()

getCodeBase

public URL getCodeBase()

获取基本的网址。这是包含此小程序的目录的网址。

结果

其中包含目录这个程序的基础 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

从以下版本开始：

一点七

另请参见：

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给基地的形象定位。

name -图像的位置，相对于 url论点。

结果

在指定的网址的图像。

另请参见：

Image

newAudioClip

public static final AudioClip newAudioClip(URL url)

从给定的网址获取音频剪辑。

参数

url点到音频剪辑

结果

在指定的网址的音频剪辑。

从以下版本开始：

一点二

getAudioClip

public AudioClip getAudioClip(URL url)

返回由 URL参数指定的 AudioClip对象。

此方法总是立即返回，是否存在音频剪辑。当这个小程序试图播放音频剪辑时，数据将被加载。

参数

url -绝对URL给音频剪辑的位置。

结果

在指定的网址的音频剪辑。

另请参见：

AudioClip

getAudioClip

public AudioClip getAudioClip(URL url,
                              String name)

返回 AudioClip对象指定的 URL和 name参数。

此方法总是立即返回，是否存在音频剪辑。当这个小程序试图播放音频剪辑时，数据将被加载。

参数

url -绝对URL给音频剪辑的基地位置。

name -音频剪辑的位置，相对于 url论点。

结果

在指定的网址的音频剪辑。

另请参见：

AudioClip

getAppletInfo

public String getAppletInfo()

返回此小程序的信息。一个程序应重写此方法以返回一个 String包含关于作者、版本信息和程序的版权。

该方法通过Applet类提供实现返回null。

结果

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

getLocale

public Locale getLocale()

获取小程序的区域设置。它允许程序维护自己的区域从浏览器或APPLETVIEWER现场分离。

重写：

getLocale 方法重写，继承类 Component

结果

小程序的区域设置；如果没有设置的区域设置，则返回默认的区域设置。

从以下版本开始：

JDK1.1

另请参见：

Component.setLocale(java.util.Locale)

getParameterInfo

public String[][] getParameterInfo()

返回由这个小程序所理解的参数的信息。一个程序应重写此方法以返回 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给音频剪辑的位置。

play

public void play(URL url,
                 String name)

具有给定的URL和规范，是相对于它的音频剪辑。如果找不到音频剪辑，什么都不会发生。

参数

url -绝对URL给音频剪辑的基地位置。

name -音频剪辑的位置，相对于 url论点。

init

public void init()

由浏览器或小程序浏览器调用来通知这个小程序，它已加载到系统中。它总是， start方法被称为第一次在叫。

对Applet子类应重写此方法，如果它已经初始化完成。例如，带螺纹的小程序将使用init方法创建线程和杀死他们的destroy方法。

该方法通过Applet类提供的实现不做任何事情。

另请参见：

destroy()， start()， stop()

start

public void start()

由浏览器或小程序浏览器调用的通知这个小程序，它应该开始它的执行。这是 init方法后，每次打开一个网页的重新审视。

对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()

由浏览器或小程序浏览器调用来通知这个小程序，它应该停止执行。它被调用时，包含这个小程序的网页已被另一个页面所取代，也就是在小程序被破坏之前。

对Applet子类应重写此方法，如果有想做一次包含它的网页不再是可见的任何操作。例如，动画小程序可能需要使用start方法恢复动画，和stop方法暂停动画。

该方法通过Applet类提供的实现不做任何事情。

另请参见：

destroy()， init()

destroy

public void destroy()

由浏览器或小程序浏览器调用来通知这个小程序，它正在被回收，它应该破坏它所分配的任何资源。的 stop方法将总是被称为 destroy

对Applet子类应重写此方法，如果有，它希望在它被摧毁之前执行任何操作。例如，带螺纹的小程序将使用init方法创建线程和杀死他们的destroy方法。

该方法通过Applet类提供的实现不做任何事情。

之前。

另请参见：

init()， start()， stop()

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与该程序相关的accessiblecontext。对于应用程序，需要的accessiblecontext的accessibleapplet形式。一个新的accessibleapplet实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 Panel

结果

一个accessibleapplet作为这个程序的accessiblecontext

从以下版本开始：

一点三