Module  java.desktop
软件包  java.awt.event

Class ActionEvent

  • All Implemented Interfaces:
    Serializable 

    public class ActionEvent
extends AWTEvent
    指示组件定义的动作发生的语义事件。 当发生组件特定操作（例如被按下）时，此高级事件由组件（例如Button ）生成。 事件被传递给使用组件的addActionListener方法注册接收此类事件的每个ActionListener对象。

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

    当事件发生时，实现ActionListener接口的对象获得此ActionEvent 。 因此，监听器不需要处理单个鼠标移动和鼠标点击的细节，而是可以处理像“按钮”一样的“有意义”（语义）事件。

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

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

    • 字段详细信息

      • SHIFT_MASK

        public static final int SHIFT_MASK
        班次修改。 在事件期间转移键被按下的指示器。
        另请参见：
        Constant Field Values

      • CTRL_MASK

        public static final int CTRL_MASK
        控制修饰符。 在事件期间控制键被按下的指示器。
        另请参见：
        Constant Field Values

      • META_MASK

        public static final int META_MASK
        元修饰符。 事件中元键被按下的一个指标。
        另请参见：
        Constant Field Values

      • ALT_MASK

        public static final int ALT_MASK
        alt修饰符。 在事件期间Alt键被按下的指示器。
        另请参见：
        Constant Field Values

      • ACTION_FIRST

        public static final int ACTION_FIRST
        用于动作事件的ids范围中的第一个数字。
        另请参见：
        Constant Field Values

      • ACTION_LAST

        public static final int ACTION_LAST
        用于操作事件的ID的范围中的最后一个数字。
        另请参见：
        Constant Field Values

      • ACTION_PERFORMED

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

    • 构造方法详细信息

      • ActionEvent

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

        此方法抛出IllegalArgumentException如果source为null 。 A 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 。 A 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 。 A null command字符串是合法的，但不推荐。

        参数
        source - 发起事件的对象
        id - 一个标识事件的整数。 有关允许值的信息，请参阅ActionEvent的类描述
        command - 可以指定与事件关联的命令（可能是其中一个）的字符串
        modifiers - 修改器在事件期间按下（shift，ctrl，alt，meta）。 不推荐传递负参数。 零值表示没有通过修饰符
        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
        结果
        标识事件及其相关命令的字符串