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

Class ActionEvent

  • 实现的所有接口
    Serializable

    public class ActionEvent
    extends AWTEvent
    一个语义事件,指示发生了组件定义的操作。 当特定于组件的操作发生时(例如被按下),该组件(例如Button )会生成此高级事件。 事件将传递给每个注册为使用组件的addActionListener方法接收此类事件的ActionListener对象。

    注意:要调用ActionEventButton使用键盘,使用空格键。

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

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

    从以下版本开始:
    1.1
    另请参见:
    ActionListenerTutorial: How to Write an Action ListenerSerialized 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

        @Native
        public static final int ACTION_PERFORMED
        此事件ID表示发生了有意义的操作。
        另请参见:
        常数字段值
    • 构造方法详细信息

      • ActionEvent

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

        此方法抛出IllegalArgumentException如果sourcenull 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如果sourcenull 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如果sourcenull 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
        结果
        标识事件及其相关命令的字符串