- java.lang.Object
-
- java.util.EventObject
-
- java.awt.AWTEvent
-
- java.awt.event.ActionEvent
-
- 实现的所有接口
-
Serializable
public class ActionEvent extends 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
-
-
字段汇总
字段 变量和类型 字段 描述 static int
ACTION_FIRST
用于动作事件的id范围中的第一个数字。static int
ACTION_LAST
用于动作事件的id范围中的最后一个数字。static int
ACTION_PERFORMED
此事件ID表示发生了有意义的操作。static int
ALT_MASK
alt修饰符。static int
CTRL_MASK
控制修饰符。static int
META_MASK
元修饰符。static int
SHIFT_MASK
移位修饰符。-
声明的属性在类 java.awt.AWTEvent
ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK
-
声明的属性在类 java.util.EventObject
source
-
-
构造方法摘要
构造方法 构造器 描述 ActionEvent(Object source, int id, String command)
构造一个ActionEvent
对象。ActionEvent(Object source, int id, String command, int modifiers)
使用修饰键构造一个ActionEvent
对象。ActionEvent(Object source, int id, String command, long when, int modifiers)
使用指定的修饰键和时间戳构造一个ActionEvent
对象。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 String
getActionCommand()
返回与此操作关联的命令字符串。int
getModifiers()
返回此动作事件期间按下的修饰键。long
getWhen()
返回此事件发生的时间戳。String
paramString()
返回标识此操作事件的参数字符串。-
声明方法的类 java.util.EventObject
getSource
-
-
-
-
字段详细信息
-
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范围中的最后一个数字。- 另请参见:
- 常数字段值
-
-
构造方法详细信息
-
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
- 结果
- 标识事件及其相关命令的字符串
-
-