JavaTM 2 Platform
Standard Ed. 5.0

java.awt.event
类 ActionEvent

java.lang.Object
  继承者 java.util.EventObject
      继承者 java.awt.AWTEvent
          继承者 java.awt.event.ActionEvent
所有已实现的接口:
Serializable

public class ActionEvent
extends AWTEvent

指示发生了组件定义的动作的语义事件。当特定于组件的动作(比如被按下)发生时,由组件(比如 Button)生成此高级别事件。事件被传递给每一个 ActionListener 对象,这些对象是使用组件的 addActionListener 方法注册的,用以接收这类事件。

注:要使用键盘在 Button 上触发 ActionEvent,请使用空格键。

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

从以下版本开始:
1.1
另请参见:
ActionListener, Tutorial: Java 1.1 Event Model, Reference: The Java Class Libraries (update file), 序列化表格

字段摘要
static int ACTION_FIRST
          用于标识动作事件的 ID 序列的起始编号。
static int ACTION_LAST
          用于标识动作事件的 ID 序列的结束编号。
static int ACTION_PERFORMED
          此事件 id 指示发生了有意义的动作。
static int ALT_MASK
          alt 修饰符。
static int CTRL_MASK
          Ctrl 修饰符。
static int META_MASK
          meta 修饰符。
static int SHIFT_MASK
          shift 修饰符。
 
从类 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.awt.AWTEvent 继承的方法
consume, getID, isConsumed, setSource, toString
 
从类 java.util.EventObject 继承的方法
getSource
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

SHIFT_MASK

public static final int SHIFT_MASK
shift 修饰符。指示 shift 键在发生事件期间是否被按下的指示器。

另请参见:
常量字段值

CTRL_MASK

public static final int CTRL_MASK
Ctrl 修饰符。指示 Ctrl 键在发生事件期间是否被按下的指示器。

另请参见:
常量字段值

META_MASK

public static final int META_MASK
meta 修饰符。指示 meta 键在发生事件期间是否被按下的指示器。

另请参见:
常量字段值

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

public static final int ACTION_PERFORMED
此事件 id 指示发生了有意义的动作。

另请参见:
常量字段值
构造方法详细信息

ActionEvent

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

注意,传入无效 id 会导致未指定的行为。如果 sourcenull,则此方法抛出 IllegalArgumentException。为 nullcommand 字符串是合法的,但不建议使用。

参数:
source - 发起事件的对象
id - 标识事件的整数
command - 一个字符串,它可以用来指定与事件所相关的一条命令(可能是几个中的一个)
抛出:
IllegalArgumentException - 如果 source 为 null

ActionEvent

public ActionEvent(Object source,
                   int id,
                   String command,
                   int modifiers)
使用组合键构造一个 ActionEvent 对象。

注意,传入无效 id 会导致未指定的行为。如果 sourcenull,则此方法抛出 IllegalArgumentException。为 nullcommand 字符串是合法的,但不建议使用。

参数:
source - 发起事件的对象
id - 标识事件的整数
command - 一个字符串,它可以用来指定与事件所相关的一条命令(可能是几个中的一个)
modifiers - 进行此动作期间按下的组合键
抛出:
IllegalArgumentException - 如果 source 为 null

ActionEvent

public ActionEvent(Object source,
                   int id,
                   String command,
                   long when,
                   int modifiers)
使用指定组合键和时间戳构造一个 ActionEvent 对象。

注意,传入无效 id 会导致未指定的行为。如果 sourcenull,则此方法抛出 IllegalArgumentException。为 nullcommand 字符串是合法的,但不建议使用。

参数:
source - 发起事件的对象
id - 标识事件的整数
command - 一个字符串,它可以用来指定与事件所相关的一条命令(可能是几个中的一个)
when - 发生事件的时间
modifiers - 进行此动作期间按下的组合键
抛出:
IllegalArgumentException - 如果 source 为 null
从以下版本开始:
1.4
方法详细信息

getActionCommand

public String getActionCommand()
返回与此动作相关的命令字符串。这使得 "modal" 组件可以由其当前的状态,通过此字符串来得到它能够产生的几个命令之一。例如,单个按钮可以在“显示详细信息”和“隐藏详细信息”之间切换。在所有情况下,源对象和事件都将是相同的,但命令字符串将会标识出实际对应的动作。

注意,如果将 null 命令字符串传递给此 ActionEvent 的构造方法,则此方法返回 null

返回:
标识此事件命令的字符串

getWhen

public long getWhen()
返回发生此事件时的时间戳。因为 ActionEvent 是一个高级别语义事件,所以时间戳通常与基础 InputEvent 相同。

返回:
此事件的时间戳
从以下版本开始:
1.4

getModifiers

public int getModifiers()
返回发生此动作事件期间按下的组合键。

返回:
修饰符常量的按位或

paramString

public String paramString()
返回标识此动作事件的参数字符串。此方法对于事件记录和调试很有用。

覆盖:
AWTEvent 中的 paramString
返回:
标识事件及其相关命令的字符串

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策