Module java.desktop
Package java.awt.event

Class 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
参见:

  • Field Details

    • SHIFT_MASK

      public static final int SHIFT_MASK
      shift修饰符。指示事件期间按下了Shift键。
      参见:

    • CTRL_MASK

      public static final int CTRL_MASK
      控制修饰符。指示事件期间按下了Control键。
      参见:

    • META_MASK

      public static final int META_MASK
      meta修饰符。指示事件期间按下了Meta键。
      参见:

    • 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表示发生了有意义的动作。
      参见:

  • Constructor Details

    • ActionEvent

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

      如果source为null，此方法会抛出IllegalArgumentException。允许使用null command字符串，但不建议。

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

    • 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为null
      参见:

    • 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为null
      自:
      1.4
      参见:

  • Method Details

    • 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
      返回:
      标识事件及其关联命令的字符串