模块  java.desktop
软件包  java.awt.event

Class ActionEvent

  • 实现的所有接口
    Serializable 
    public class ActionEventextends AWTEvent
    一个语义事件，指示发生了组件定义的操作。 当特定于组件的操作发生时（例如被按下），该组件（例如Button ）会生成此高级事件。 事件将传递给每个注册为使用组件的addActionListener方法接收此类事件的ActionListener对象。

    注意：要调用ActionEvent在Button使用键盘，使用空格键。

    事件发生时，实现ActionListener接口的对象获取此ActionEvent 。 因此，听众可以省去处理单个鼠标移动和鼠标点击的细节，而是可以处理像“按下按钮”这样的“有意义”（语义）事件。

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

    从以下版本开始：
    1.1
    另请参见：
    ActionListener ， Tutorial: How to Write an Action Listener ， Serialized Form

    • 字段详细信息

      • 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

        @Nativepublic static final int ACTION_PERFORMED
        此事件ID表示发生了有意义的操作。
        另请参见：
        常数字段值

    • 构造方法详细信息

      • ActionEvent

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

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

        参数
        source - 发起事件的对象
        id - 标识事件的整数。 有关允许值的信息，请参阅ActionEvent的类说明
        command - 可以指定与事件关联的命令（可能是其中一个命令）的字符串
        异常
        IllegalArgumentException - 如果 source为空
        另请参见：
        EventObject.getSource() ， AWTEvent.getID() ， getActionCommand()

      • ActionEvent

        public ActionEvent​(Object source,                   int id,                   String command,                   int modifiers)
        使用修饰键构造一个ActionEvent对象。

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

        参数
        source - 发起事件的对象
        id - 标识事件的整数。 有关允许值的信息，请参阅ActionEvent的类说明
        command - 可以指定与事件关联的命令（可能是其中一个命令）的字符串
        modifiers - 在事件（shift，ctrl，alt，meta）期间修改键按下。 不建议传递负参数。 零值表示没有传递修饰符
        异常
        IllegalArgumentException - 如果 source为空
        另请参见：
        EventObject.getSource() ， AWTEvent.getID() ， getActionCommand() ， getModifiers()

      • ActionEvent

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

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

        参数
        source - 发起事件的对象
        id - 标识事件的整数。 有关允许值的信息，请参阅ActionEvent的类说明
        command - 可以指定与事件关联的命令（可能是其中一个命令）的字符串
        modifiers - 修改器在事件期间按下键（shift，ctrl，alt，meta）。 不建议传递负参数。 零值表示没有传递修饰符
        when - 给出事件发生时间的长when 。 建议不要传递负值或零值
        异常
        IllegalArgumentException - 如果 source为空
        从以下版本开始：
        1.4
        另请参见：
        EventObject.getSource() ， AWTEvent.getID() ， getActionCommand() ， getModifiers() ， getWhen()

    • 方法详细信息

      • getActionCommand

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

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

        结果
        标识此事件命令的字符串

      • getWhen

        public long getWhen()
        返回此事件发生的时间戳。 因为ActionEvent是一个高级语义事件，所以时间戳通常与底层的InputEvent相同。
        结果
        这个事件的时间戳
        从以下版本开始：
        1.4

      • getModifiers

        public int getModifiers()
        返回此动作事件期间按下的修饰键。
        结果
        按位或修饰符常量

      • paramString

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