java.awt.event

Class ActionEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.ActionEvent

All Implemented Interfaces:

Serializable

public class ActionEvent
extends AWTEvent

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

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

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

如果未指定的行为将引起id任何特定的参数ActionEvent实例不在范围从ACTION_FIRST到ACTION_LAST 。

从以下版本开始：

1.1

另请参见：

ActionListener ， Tutorial: How to Write an Action Listener ， Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	ACTION_FIRST 用于动作事件的ids范围中的第一个数字。
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 班次修改。

Fields inherited from class 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

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
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对象。

方法摘要

Modifier and Type	Method and Description
String	getActionCommand() 返回与此操作相关联的命令字符串。
int	getModifiers() 返回此操作事件期间按住的修饰键。
long	getWhen() 返回发生此事件的时间戳。
String	paramString() 返回标识此操作事件的参数字符串。

Methods inherited from class java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

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 ，则此方法返回null 。

结果

该字符串标识此事件的命令

getWhen

public long getWhen()

返回发生此事件的时间戳。 因为ActionEvent是一个高级语义事件，所以时间戳通常与底层的InputEvent相同。

结果

这个事件的时间戳

从以下版本开始：

1.4

getModifiers

public int getModifiers()

返回此操作事件期间按住的修饰键。

结果

按位或修饰符常数

paramString

public String paramString()

返回标识此操作事件的参数字符串。 此方法对于事件记录和调试很有用。

重写：

paramString在类别 AWTEvent

结果

标识事件及其相关命令的字符串