模块 java.desktop
包 java.awt.event

类 ActionEvent

java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.ActionEvent
所有已实现的接口：
Serializable
public class ActionEvent extends AWTEvent
指示组件定义的操作发生的语义事件。当特定于组件的操作发生（例如被按下）时，此高级事件由组件（例如 Button ）生成。该事件被传递给每个注册为使用组件的 addActionListener 方法接收此类事件的 ActionListener 对象。

笔记：要使用键盘在 Button 上调用 ActionEvent，请使用空格键。

当事件发生时，实现 ActionListener 接口的对象会得到这个 ActionEvent。因此，监听器省去了处理单个鼠标移动和鼠标单击的细节，而是可以处理“有意义的”（语义）事件，如“按下按钮”。

如果任何特定 ActionEvent 实例的 id 参数不在 ACTION_FIRST 到 ACTION_LAST 的范围内，将导致未指定的行为。

自从：
1.1
参见：

  • 字段详细信息

    • SHIFT_MASK

      public static final int SHIFT_MASK
      移位修饰符。指示在事件期间按住 Shift 键。
      参见：

    • CTRL_MASK

      public static final int CTRL_MASK
      控制修饰符。指示在事件期间控制键被按住。
      参见：

    • META_MASK

      public static final int META_MASK
      元修饰符。指示元键在事件期间被按住的指示符。
      参见：

    • ALT_MASK

      public static final int ALT_MASK
      alt修饰符。指示在事件期间按住 alt 键。
      参见：

    • ACTION_FIRST

      public static final int ACTION_FIRST
      用于动作事件的 ID 范围内的第一个数字。
      参见：

    • ACTION_LAST

      public static final int ACTION_LAST
      用于动作事件的 ID 范围内的最后一个数字。
      参见：

    • ACTION_PERFORMED

      @Native public static final int ACTION_PERFORMED
      此事件 ID 表示发生了有意义的操作。
      参见：

  • 构造方法详细信息

    • ActionEvent

      public ActionEvent(Object  source, int id, String  command)
      构造一个 ActionEvent 对象.

      如果 source 是 null，此方法将抛出 IllegalArgumentException。 null command 字符串是合法的，但不推荐使用。

      参数：
      source - 发起事件的对象
      id - 标识事件的整数。有关允许值的信息，请参阅 ActionEvent 的类描述
      command - 可以指定与事件关联的命令（可能是多个命令之一）的字符串
      抛出：
      IllegalArgumentException - 如果 source 为空
      参见：

    • ActionEvent

      public ActionEvent(Object  source, int id, String  command, int modifiers)
      构造一个带有修改键的 ActionEvent 对象。

      如果 source 是 null，此方法将抛出 IllegalArgumentException。 null command 字符串是合法的，但不推荐使用。

      参数：
      source - 发起事件的对象
      id - 标识事件的整数。有关允许值的信息，请参阅 ActionEvent 的类描述
      command - 可以指定与事件关联的命令（可能是多个命令之一）的字符串
      modifiers - 在事件期间按下修饰键（shift、ctrl、alt、meta）。不建议传递负参数。零值意味着没有传递修饰符
      抛出：
      IllegalArgumentException - 如果 source 为空
      参见：

    • ActionEvent

      public ActionEvent(Object  source, int id, String  command, long when, int modifiers)
      使用指定的修饰键和时间戳构造一个 ActionEvent 对象。

      如果 source 是 null，此方法将抛出 IllegalArgumentException。 null command 字符串是合法的，但不推荐使用。

      参数：
      source - 发起事件的对象
      id - 标识事件的整数。有关允许值的信息，请参阅 ActionEvent 的类描述
      command - 可以指定与事件关联的命令（可能是多个命令之一）的字符串
      when - 给出事件发生时间的长整数。不建议传递负值或零值
      modifiers - 在事件期间按下修饰键（shift、ctrl、alt、meta）。不建议传递负参数。零值意味着没有传递修饰符
      抛出：
      IllegalArgumentException - 如果 source 为空
      自从：
      1.4
      参见：

  • 方法详情

    • getActionCommand

      public String  getActionCommand()
      返回与此操作关联的命令字符串。该字符串允许“模态”组件根据其状态指定多个命令之一。例如，单个按钮可能会在“显示详细信息”和“隐藏详细信息”之间切换。源对象和事件在每种情况下都是相同的，但命令字符串将标识预期的操作。

      请注意，如果将 null 命令字符串传递给此 ActionEvent 的构造函数，此方法将返回 null。

      返回：
      标识此事件命令的字符串

    • getWhen

      public long getWhen()
      返回此事件发生时的时间戳。因为 ActionEvent 是高级语义事件，所以时间戳通常与基础 InputEvent 相同。
      返回：
      这个事件的时间戳
      自从：
      1.4

    • getModifiers

      public int getModifiers()
      返回在此操作事件期间按住的修改键。
      返回：
      修饰符常量的按位或

    • paramString

      public String  paramString()
      返回标识此操作事件的参数字符串。此方法对于事件记录和调试很有用。
      重写：
      paramString 在类 AWTEvent 中
      返回：
      标识事件及其关联命令的字符串