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）当组件特定的动作（比如被按下）。事件传递到每一个 ActionListener对象注册到使用组件的 addActionListener方法接收这样的事件。

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

实现ActionListener接口获取这ActionEvent事件发生时的对象。因此，听者不遗余力地处理单个鼠标的动作和鼠标点击的细节，并可以代替过程中一个“有意义的”（语义）的事件，如“按钮按下”。

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

从以下版本开始：

一点一

另请参见：

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

Field Summary

Fields

Modifier and Type	Field and Description
static int	ACTION_FIRST 用于操作事件的入侵检测系统范围内的第一个数字。
static int	ACTION_LAST 用于操作事件的入侵检测系统范围内的最后一个数字。
static int	ACTION_PERFORMED 此事件标识表示发生了一个有意义的动作。
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

Field Detail

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

用于操作事件的入侵检测系统范围内的第一个数字。

另请参见：

Constant Field Values

ACTION_LAST

public static final int ACTION_LAST

用于操作事件的入侵检测系统范围内的最后一个数字。

另请参见：

Constant Field Values

ACTION_PERFORMED

@Native
public static final int ACTION_PERFORMED

此事件标识表示发生了一个有意义的动作。

另请参见：

Constant Field Values

Constructor Detail

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、元）。不建议通过负参数。零值意味着没有通过的修饰语

异常

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、元）。不建议通过负参数。零值意味着没有通过的修饰语

when -长出时间发生的事件。不建议通过负或零值

异常

IllegalArgumentException -如果 source是空的

从以下版本开始：

一点四

另请参见：

EventObject.getSource()， AWTEvent.getID()， getActionCommand()， getModifiers()， getWhen()

方法详细信息

getActionCommand

public String getActionCommand()

返回与此操作关联的命令字符串。这个字符串允许一个“模态”组件来指定几个命令之一，取决于它的状态。例如，一个单一的按钮可能会在“显示细节”和“隐藏细节”之间切换。在每一种情况下，源对象和事件将是相同的，但命令字符串将确定预期的动作。

注意，如果一个null命令字符串传递给构造函数这ActionEvent，此方法返回null。

结果

确定此事件的命令的字符串

getWhen

public long getWhen()

返回的时间戳，这件事发生的时候。因为一个ActionEvent是一种高级语义事件的时间戳，通常是作为一个潜在的inputevent相同。

结果

这一事件的时间戳

从以下版本开始：

一点四

getModifiers

public int getModifiers()

返回在此操作事件中按住的修改键键。

结果

按位或修改常数

paramString

public String paramString()

返回一个确定此操作事件的参数字符串。此方法用于事件日志记录和调试是有用的。

重写：

paramString 方法重写，继承类 AWTEvent

结果

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