java.awt

Class Button

java.lang.Object

java.awt.Component

java.awt.Button

All Implemented Interfaces:

ImageObserver， MenuContainer， Serializable， Accessible

public class Button
extends Component
implements Accessible

这个类创建一个标记按钮。该应用程序可能会导致一些动作发生时，按钮被按下。这幅描绘了一个“ Quit”按钮显示在Solaris操作系统下的三种观点：

第一个视图显示了按钮，因为它通常出现。第二个视图显示了当它有输入焦点时的按钮。它的轮廓是黑暗的，让用户知道它是一个活跃的对象。当用户在按钮上单击鼠标时，第三视图显示该按钮，因此请求执行一个动作。

点击一个鼠标手势与ActionEvent一实例关联，发出的是当鼠标按下和释放都在按钮。如果应用程序想知道当按钮被按下而不公布，作为一个单独的动作，它可以processMouseEvent，或可登记本身作为一个叫addMouseListener鼠标事件的监听器。这些方法都是由Component，所有组件的抽象类。

当一个按钮被按下和释放，AWT将ActionEvent实例按钮，在按钮调用processEvent。按钮的processEvent方法接收的按钮，所有的事件；通过行为事件在调用自己的processActionEvent方法。后一种方法将操作事件传递给已注册的由该按钮产生的动作事件的任何动作侦听器。

如果一个应用程序需要执行基于按钮的按下和释放一些行动，应该实行ActionListener和登记从这个按钮接收事件的新听众，通过调用按钮的addActionListener方法。该应用程序可以使用该按钮的动作命令作为消息传递协议。

从以下版本开始：

JDK1.0

另请参见：

ActionEvent， ActionListener， Component.processMouseEvent(java.awt.event.MouseEvent)， Component.addMouseListener(java.awt.event.MouseListener)， Serialized Form

Nested Class Summary

Nested Classes

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

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

accessibleContext, 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
Button() 用一个空字符串构造一个它的标签的按钮。
Button(String label) 用指定的标签构造一个按钮。

方法摘要

Modifier and Type	Method and Description
void	addActionListener(ActionListener l) 添加指定的操作侦听器从该按钮接收动作事件。
void	addNotify() 创建按钮的对等点。
AccessibleContext	getAccessibleContext() 获取与此相关的 AccessibleContext Button。
String	getActionCommand() 返回由此按钮触发的动作事件的命令名称。
ActionListener[]	getActionListeners() 返回在这个按钮上注册的所有操作侦听器的数组。
String	getLabel() 获取此按钮的标签。
<T extends EventListener> T[]	getListeners(类<T> listenerType) 返回对象的当前注册为 FooListeners在这 Button数组。
protected String	paramString() 返回一个字符串，表示此 Button状态。
protected void	processActionEvent(ActionEvent e) 过程行动事件发生在这个按钮上派遣他们任何注册 ActionListener对象。
protected void	processEvent(AWTEvent e) 在这个按钮上处理事件。
void	removeActionListener(ActionListener l) 移除指定的动作侦听器，以便它不再从该按钮接收动作事件。
void	setActionCommand(String command) 设置由此按钮触发的动作事件的命令名。
void	setLabel(String label) 将按钮的标签设置为指定的字符串。

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

Button

public Button()
       throws HeadlessException

用一个空字符串构造一个它的标签的按钮。

异常

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

另请参见：

GraphicsEnvironment.isHeadless()

Button

public Button(String label)
       throws HeadlessException

用指定的标签构造一个按钮。

参数

label -一个按钮的字符串标签，无标签或 null

异常

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

另请参见：

GraphicsEnvironment.isHeadless()

方法详细信息

addNotify

public void addNotify()

创建按钮的对等点。该按钮的对等允许应用程序更改按钮的外观，而不改变其功能。

重写：

addNotify 方法重写，继承类 Component

另请参见：

Toolkit.createButton(java.awt.Button)， Component.getToolkit()

getLabel

public String getLabel()

获取此按钮的标签。

结果

按钮的标签，或 null如果按钮没有标签。

另请参见：

setLabel(java.lang.String)

setLabel

public void setLabel(String label)

将按钮的标签设置为指定的字符串。

参数

label -新的标签，或 null如果按钮没有标签。

另请参见：

getLabel()

setActionCommand

public void setActionCommand(String command)

设置由此按钮触发的动作事件的命令名。默认情况下，此操作命令将设置为与按钮的标签相匹配。

参数

command -用来设置按钮的动作命令字符串。如果字符串是 null然后行动命令设置相匹配的按钮标签。

从以下版本开始：

JDK1.1

另请参见：

ActionEvent

getActionCommand

public String getActionCommand()

返回由此按钮触发的动作事件的命令名称。如果该命令名是 null（默认）那么这个方法返回按钮的标签。

addActionListener

public void addActionListener(ActionListener l)

添加指定的操作侦听器从该按钮接收动作事件。当用户在这个按钮上按下或释放鼠标时，操作事件会发生。如果L为空，则不会引发异常，并没有执行任何动作。

指对AWT的线程模型的细节AWT Threading Issues。

参数

l的监听行动

从以下版本开始：

JDK1.1

另请参见：

removeActionListener(java.awt.event.ActionListener)， getActionListeners()， ActionListener

removeActionListener

public void removeActionListener(ActionListener l)

移除指定的动作侦听器，以便它不再从该按钮接收动作事件。当用户在这个按钮上按下或释放鼠标时，操作事件会发生。如果L为空，则不会引发异常，并没有执行任何动作。

指对AWT的线程模型的细节AWT Threading Issues。

参数

l的监听行动

从以下版本开始：

JDK1.1

另请参见：

addActionListener(java.awt.event.ActionListener)， getActionListeners()， ActionListener

getActionListeners

public ActionListener[] getActionListeners()

返回在这个按钮上注册的所有操作侦听器的数组。

结果

所有这些按钮的 ActionListeners或空数组如果没有行动的听众正在注册

从以下版本开始：

一点四

另请参见：

addActionListener(java.awt.event.ActionListener)， removeActionListener(java.awt.event.ActionListener)， ActionListener

getListeners

public <T extends EventListener> T[] getListeners(类<T> listenerType)

返回对象的当前注册为 FooListeners在这 Button数组。 FooListeners使用 addFooListener方法注册。如果没有这样

您可以指定一个类的listenerType字面的说法，如FooListener.class。例如，你可以查询其监听行动与下面的代码Button b：

ALS功能[ ] =（action [ ]）（b.getlisteners（action。类））；

听众的存在，此方法将返回空数组。

重写：

getListeners 方法重写，继承类 Component

参数

listenerType -听众的类型要求；这个参数应该指定一个接口，从 java.util.EventListener

结果

所有对象注册为该按钮 FooListeners数组，或一个空数组如果没有这样的听众已添加

异常

ClassCastException -如果 listenerType不指定一个类或接口实现 java.util.EventListener

从以下版本开始：

一点三

另请参见：

getActionListeners()

processEvent

protected void processEvent(AWTEvent e)

在这个按钮上处理事件。如果一个事件是 ActionEvent实例，该方法调用 processActionEvent方法。否则，它调用父类的 processEvent上。

注意，如果参数是null行为是不可能导致异常。

重写：

processEvent 方法重写，继承类 Component

参数

e -事件

从以下版本开始：

JDK1.1

另请参见：

ActionEvent， processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent e)

过程行动事件发生在这个按钮上派遣他们任何注册 ActionListener对象。

此方法不被调用，除非为这个按钮启用了动作事件。当下列情况之一发生时，启用了动作事件：

• 一个ActionListener对象是通过addActionListener注册。
• 动作事件能够通过enableEvents。

注意，如果参数是null行为是不可能导致异常。

参数

e -动作事件

从以下版本开始：

JDK1.1

另请参见：

ActionListener， addActionListener(java.awt.event.ActionListener)， Component.enableEvents(long)

paramString

protected String paramString()

返回一个字符串，表示此 Button状态。这种方法的目的是用于调试目的，其含量和返回的字符串格式不同的实现可能会有所不同。返回的字符串是空的但可能不 null。

重写：

paramString 方法重写，继承类 Component

结果

此按钮的参数字符串

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此相关的 AccessibleContext Button。按钮，在 AccessibleContext以一个 AccessibleAWTButton形式。一个新的 AccessibleAWTButton实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 Component

结果

一个 AccessibleAWTButton作为本 Button的 AccessibleContext

从以下版本开始：

一点三