模块 java.desktop
包 java.awt

类 Button

java.lang.Object
java.awt.Component
java.awt.Button
所有已实现的接口：
ImageObserver , MenuContainer , Serializable , Accessible
public class Button extends Component implements Accessible
此类创建一个带标签的按钮。当按下按钮时，应用程序可能会导致某些操作发生。此图描绘了“Quit”按钮在 Solaris 操作系统下的三个视图：

The following context describes the graphic

第一个视图显示正常显示的按钮。第二个视图在具有输入焦点时显示按钮。它的轮廓变暗，让用户知道它是一个活动对象。第三个视图显示当用户在按钮上单击鼠标时的按钮，从而请求执行某个操作。

用鼠标单击按钮的手势与 ActionEvent 的一个实例相关联，当鼠标在按钮上按下和释放时发送。如果应用程序有兴趣了解按钮何时被按下但未释放，作为一个单独的手势，它可以专门化 processMouseEvent ，或者它可以通过调用 addMouseListener 将自己注册为鼠标事件的监听器。这两种方法都由所有组件的抽象超类 Component 定义。

当按下并释放按钮时，AWT 通过在按钮上调用 processEvent 将 ActionEvent 的实例发送到按钮。按钮的processEvent方法接收按钮的所有事件；它通过调用自己的 processActionEvent 方法来传递动作事件。后一种方法将动作事件传递给任何已注册对此按钮生成的动作事件感兴趣的动作监听器。

如果应用程序想要根据按下和释放按钮执行某些操作，它应该实现 ActionListener 并通过调用按钮的 addActionListener 方法注册新的监听器以接收来自该按钮的事件。应用程序可以使用按钮的操作命令作为消息传递协议。

自从：
1.0
参见：

  • 构造方法详细信息

  • 方法详情

    • addNotify

      public void addNotify()
      创建按钮的对等体。按钮的同位体允许应用程序更改按钮的外观而不更改其功能。
      重写：
      addNotify 在类 Component 中
      参见：

    • getLabel

      public String  getLabel()
      获取此按钮的标签。
      返回：
      按钮的标签，如果按钮没有标签，则为 null。
      参见：

    • setLabel

      public void setLabel(String  label)
      将按钮的标签设置为指定的字符串。
      参数：
      label - 新标签，如果按钮没有标签则为 null。
      参见：

    • setActionCommand

      public void setActionCommand(String  command)
      设置此按钮触发的动作事件的命令名称。默认情况下，此操作命令设置为匹配按钮的标签。
      参数：
      command - 用于设置按钮动作命令的字符串。如果字符串是 null 则动作命令被设置为匹配按钮的标签。
      自从：
      1.1
      参见：

    • getActionCommand

      public String  getActionCommand()
      返回此按钮触发的动作事件的命令名称。如果命令名称是 null（默认值），则此方法返回按钮的标签。
      返回：
      此按钮的操作命令名称（或标签）

    • addActionListener

      public void addActionListener(ActionListener  l)
      添加指定的动作监听以接收来自此按钮的动作事件。当用户在此按钮上按下或释放鼠标时，将发生操作事件。如果 l 为 null，则不会抛出异常并且不会执行任何操作。

      有关 AWT 线程模型的详细信息，请参阅 AWT 线程问题。

      参数：
      l - 动作监听器
      自从：
      1.1
      参见：

    • removeActionListener

      public void removeActionListener(ActionListener  l)
      移除指定的动作监听，使其不再接收来自该按钮的动作事件。当用户在此按钮上按下或释放鼠标时，将发生操作事件。如果 l 为 null，则不会抛出异常并且不会执行任何操作。

      有关 AWT 线程模型的详细信息，请参阅 AWT 线程问题。

      参数：
      l - 动作监听器
      自从：
      1.1
      参见：

    • getActionListeners

      public ActionListener [] getActionListeners()
      返回在此按钮上注册的所有动作监听的数组。
      返回：
      此按钮的所有 ActionListener 或空数组（如果当前没有注册任何动作监听器）
      自从：
      1.4
      参见：

    • getListeners

      public <T extends EventListener > T[] getListeners(Class <T> listenerType)
      返回当前在此 Button 上注册为 FooListener 的所有对象的数组。 FooListener 是使用 addFooListener 方法注册的。

      您可以使用类文字指定 listenerType 参数，例如 FooListener.class 。例如，您可以使用以下代码查询 Button b 的动作监听器：

      ActionListener[] als = (ActionListener[])(b.getListeners(ActionListener.class));
      如果不存在这样的监听器，则此方法返回一个空数组。
      重写：
      getListeners 在类 Component 中
      类型参数：
      T - 监听器的类型
      参数：
      listenerType - 请求的监听器类型；此参数应指定从 java.util.EventListener 派生的接口
      返回：
      在此按钮上注册为 FooListener 的所有对象的数组，如果没有添加此类监听器，则为空数组
      抛出：
      ClassCastException - 如果 listenerType 没有指定实现 java.util.EventListener 的类或接口
      自从：
      1.3
      参见：

    • processEvent

      protected void processEvent(AWTEvent  e)
      处理此按钮上的事件。如果事件是 ActionEvent 的实例，则此方法调用 processActionEvent 方法。否则，它会在超类上调用 processEvent。

      请注意，如果事件参数为 null，则行为未指定且可能导致异常。

      重写：
      processEvent 在类 Component 中
      参数：
      e - 事件
      自从：
      1.1
      参见：

    • processActionEvent

      protected void processActionEvent(ActionEvent  e)
      通过将此按钮上发生的动作事件分派给任何已注册的 ActionListener 对象来处理它们。

      除非为此按钮启用动作事件，否则不会调用此方法。当发生以下情况之一时，将启用操作事件：

      • ActionListener 对象通过 addActionListener 注册。
      • 动作事件通过 enableEvents 启用。

      请注意，如果事件参数为 null，则行为未指定且可能导致异常。

      参数：
      e - 动作事件
      自从：
      1.1
      参见：

    • paramString

      protected String  paramString()
      返回表示此 Button 状态的字符串。此方法仅用于调试目的，返回字符串的内容和格式可能因实现而异。返回的字符串可能为空，但可能不是 null 。
      重写：
      paramString 在类 Component 中
      返回：
      该按钮的参数字符串

    • getAccessibleContext

      @BeanProperty (expert =true, description ="The AccessibleContext associated with this Button.") public AccessibleContext  getAccessibleContext()
      获取与此 Button 关联的 AccessibleContext。对于按钮， AccessibleContext 采用 AccessibleAWTButton 的形式。如有必要，将创建一个新的 AccessibleAWTButton 实例。
      指定者：
      getAccessibleContext 在接口 Accessible 中
      重写：
      getAccessibleContext 在类 Component 中
      返回：
      一个 AccessibleAWTButton 作为这个 Button 的 AccessibleContext
      自从：
      1.3