类 java.awt.Button

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Button

public class Button

extends Component

该类创建一个被标记的按钮。按钮按下时，应用可导致一些动作发生。该图像描述了“退出”按钮在 Solaris 操作系统中显示的三个视图：

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

使用鼠标单击按钮的指示符与 ActionEvent 的一个实例相关，当在按钮上按下或释放鼠标时，就发送该事件。若一个应用对按钮按下尚未释放的时间感兴趣，作为一个独立的指示符，它可限定 processMouseEvent 的使用范围，或通过调用 addMouseListener 方法将其本身注册为鼠标事件监听者。所有这些方法都被 Component 类定义，这个 Component 类是所有组件的抽象父类。

当按钮被按下并被释放时，AWT 通过调用按钮上的 processEvent 方法，将一个 ActionEvent 实例发送给按钮。按钮的 processEvent 方法接收按钮的所有事件；它通过调用它本身的 processActionEvent 方法来传送一个动作事件。其后的方法将该事件传送给任意一个对该按钮产生的动作事件感兴趣的动作监听者。

若一个应用希望执行一些按钮按下并释放事件触发的动作，它应通过调用按钮的 addActionListener 方法来实现 ActionListener ，并注册新的监听者来接收来自该按钮的事件。这个应用可将按钮的动作命令作为一个信息协议来使用。

来自：

JDK1.0

参见：

ActionEvent, ActionListener, processMouseEvent, addMouseListener

构造子索引

Button()

构造一个不带标签的 Button 。

Button(String)

用指定的标签构造一个 Button 。

方法索引

addActionListener(ActionListener)

添加指定的动作监听者，接收这个按钮的动作事件。

addNotify()

创建按钮的同级件。

getActionCommand()

返回该按钮激活的动作的命令名。

getLabel()

获取该按钮的标签。

paramString()

返回表示该按钮的状态的参数字符串。

processActionEvent(ActionEvent)

通过将动作事件分配给任意一个已注册的 ActionListener 对象，处理发生在该按钮上的动作事件。

processEvent(AWTEvent)

处理该按钮上的事件。

removeActionListener(ActionListener)

删除指定的动作监听者，使其不再接收该按钮的动作事件。

setActionCommand(String)

设置该按钮激活的动作事件的命令名。

setLabel(String)

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

构造子

 public Button()

构造一个不带标签的 Button 。

 public Button(String label)

用指定的标签构造一个 Button 。

参数：

label - 按钮的字符串标签。

方法

 public void addNotify()

创建按钮的同级件。按钮的同级件允许在不改变按钮功能的情况下，改变其外观。

覆盖：

类 Component 中的 addNotify

参见：

createButton, getToolkit

 public String getLabel()

获取该按钮的标签。

返回值：

按钮的标签，若按钮没有标签，则返回 null 。

参见：

setLabel

 public synchronized void setLabel(String label)

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

参数：

label - 新的标签，若为 null ，表示按钮没有标签。

参见：

getLabel

 public void setActionCommand(String command)

设置该按钮激活的动作事件的命令名。该动作命令缺省设置为与按钮的标签匹配。

参数：

command - 用于设置按钮的动作命令的字符串。

参见：

ActionEvent

 public String getActionCommand()

返回该按钮激活的动作的命令名。

 public synchronized void addActionListener(ActionListener l)

添加指定的动作监听者，接收这个按钮的动作事件。当用户在该按钮上按下或释放鼠标时，发生动作事件。

参数：

l - 动作监听者。

参见：

ActionListener, removeActionListener

 public synchronized void removeActionListener(ActionListener l)

删除指定的动作监听者，使其不再接收该按钮的动作事件。当用户在该按钮上按下或释放鼠标时，发生动作事件。

参数：

l - 动作监听者。

参见：

ActionListener, addActionListener

 protected void processEvent(AWTEvent e)

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

参数：

e - 事件。

覆盖：

类 Component 中的 processEvent

参见：

ActionEvent, processActionEvent

 protected void processActionEvent(ActionEvent e)

通过将动作事件分配给任意一个已注册的 ActionListener 对象，处理发生在该按钮上的动作事件。

除非这个组件可以启用动作事件，否则不能调用此方法。当如下条件之一发生时，可以启用动作事件：

• 通过addActionListener方法，注册了一个 ActionListener 对象。
• 通过 enableEvents方法，使动作事件可以启用。

参数：

e - 动作事件。

参见：

ActionListener, addActionListener, enableEvents

 protected String paramString()

返回表示该按钮的状态的参数字符串。该字符串对调试有用。

返回值：

该按钮的参数字符串。

覆盖：

类 Component 中的 paramString