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, 序列化表格

欄位摘要

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 會導致未指定的行為。如果 source 為 null，則此方法拋出 IllegalArgumentException。為 null 的 command 字元串是合法的，但不建議使用。

參數：

source - 發起事件的物件

id - 標識事件的整數

command - 一個字元串，它可以用來指定與事件所相關的一條命令（可能是幾個中的一個）

拋出：

IllegalArgumentException - 如果 source 為 null

ActionEvent

public ActionEvent(Object source,
                   int id,
                   String command,
                   int modifiers)

使用修改鍵建構一個 ActionEvent 物件。

注意，傳入無效 id 會導致未指定的行為。如果 source 為 null，則此方法拋出 IllegalArgumentException。為 null 的 command 字元串是合法的，但不建議使用。

參數：

source - 發起事件的物件

id - 標識事件的整數

command - 一個字元串，它可以用來指定與事件所相關的一條命令（可能是幾個中的一個）

modifiers - 進行此動作期間按下的修改鍵

拋出：

IllegalArgumentException - 如果 source 為 null

ActionEvent

public ActionEvent(Object source,
                   int id,
                   String command,
                   long when,
                   int modifiers)

使用指定修改鍵和時間戳建構一個 ActionEvent 物件。

注意，傳入無效 id 會導致未指定的行為。如果 source 為 null，則此方法拋出 IllegalArgumentException。為 null 的 command 字元串是合法的，但不建議使用。

參數：

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

返回：

標識事件及其相關命令的字元串