java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.ActionEvent
- すべての実装されたインタフェース:
Serializable
public class ActionEvent extends AWTEvent
コンポーネントが定義するアクションが発生したことを示す、セマンティック・イベントです。 この高レベル・イベントは、コンポーネント(
Button
など)固有アクションが発生したときに(押されたなど)、コンポーネントによって生成されます。 イベントは、コンポーネントのaddActionListener
メソッドを使って、それらのイベントを受け取るように登録されているすべてのActionListener
オブジェクトに渡されます。
ノート: キーボードを使用してButton
でActionEvent
を呼び出すには、スペース・バーを使用します。
ActionListener
インタフェースを実装するオブジェクトは、イベントが発生したときにこのActionEvent
を取得します。 したがってリスナーは、個々のマウス移動やマウス・クリックを詳細に処理することなく、「ボタンが押された」などの「意味のある(セマンティック)」イベントを処理できます。
特定のActionEvent
インスタンスのid
パラメータがACTION_FIRST
からACTION_LAST
までの範囲にない場合に、未指定の動作が発生します。
- 導入されたバージョン:
- 1.1
- 関連項目:
ActionListener
, Tutorial: How to Write an Action Listener, 直列化された形式
-
フィールドのサマリー
修飾子と型フィールド説明static int
アクション・イベントに使用されるIDの範囲内の最初の番号です。static int
アクション・イベントに使用されるIDの範囲内の最後の番号です。static int
このイベントIDは、意味のあるアクションが発生したことを示します。static int
Alt修飾子です。static int
Ctrl修飾子です。static int
Meta修飾子です。static int
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
オブジェクトを構築します。 -
メソッドのサマリー
修飾子と型メソッド説明このアクションに関連付けられたコマンド文字列を返します。int
このアクション・イベント中に押された修飾キーを返します。long
getWhen()
このイベントが発生した時点のタイムスタンプを返します。このアクション・イベントを識別するパラメータ文字列を返します。クラス java.util.EventObjectで宣言されたメソッド
getSource
-
フィールド詳細
-
SHIFT_MASK
public static final int SHIFT_MASKShift修飾子です。 イベント中にShiftキーが押されたことを示します。- 関連項目:
- 定数フィールド値
-
CTRL_MASK
public static final int CTRL_MASKCtrl修飾子です。 イベント中にCtrlキーが押されたことを示します。- 関連項目:
- 定数フィールド値
-
META_MASK
public static final int META_MASKMeta修飾子です。 イベント中にMetaキーが押されたことを示します。- 関連項目:
- 定数フィールド値
-
ALT_MASK
public static final int ALT_MASKAlt修飾子です。 イベント中にAltキーが押されたことを示します。- 関連項目:
- 定数フィールド値
-
ACTION_FIRST
public static final int ACTION_FIRSTアクション・イベントに使用されるIDの範囲内の最初の番号です。- 関連項目:
- 定数フィールド値
-
ACTION_LAST
public static final int ACTION_LASTアクション・イベントに使用されるIDの範囲内の最後の番号です。- 関連項目:
- 定数フィールド値
-
ACTION_PERFORMED
@Native public static final int ACTION_PERFORMEDこのイベントIDは、意味のあるアクションが発生したことを示します。- 関連項目:
- 定数フィールド値
-
-
コンストラクタの詳細
-
ActionEvent
ActionEvent
オブジェクトを構築します。このメソッドは
source
がnull
の場合にIllegalArgumentException
をスローします。null command
文字列は誤りではありませんが、非推奨です。- パラメータ:
source
- イベントを発生させたオブジェクトid
- イベントを識別する整数。 許容される値については、ActionEvent
のクラスの説明を参照してください。command
- イベントに関連付ける1つのコマンド(または複数のコマンドのいずれか)を指定できる文字列- 例外:
IllegalArgumentException
-source
がnullである場合- 関連項目:
EventObject.getSource()
,AWTEvent.getID()
,getActionCommand()
-
ActionEvent
修飾キーでActionEvent
オブジェクトを構築します。このメソッドは
source
がnull
の場合にIllegalArgumentException
をスローします。null command
文字列は誤りではありませんが、非推奨です。- パラメータ:
source
- イベントを発生させたオブジェクトid
- イベントを識別する整数。 許容される値については、ActionEvent
のクラスの説明を参照してください。command
- イベントに関連付ける1つのコマンド(または複数のコマンドのいずれか)を指定できる文字列modifiers
- イベント中に押された修飾キー(Shift、Ctrl、Alt、Meta)。 負の値のパラメータを渡すことはお薦めできません。 ゼロの値は修飾子が渡されなかったことを意味します- 例外:
IllegalArgumentException
-source
がnullである場合- 関連項目:
EventObject.getSource()
,AWTEvent.getID()
,getActionCommand()
,getModifiers()
-
ActionEvent
指定された修飾キーとタイムスタンプでActionEvent
オブジェクトを構築します。このメソッドは
source
がnull
の場合にIllegalArgumentException
をスローします。null command
文字列は誤りではありませんが、非推奨です。- パラメータ:
source
- イベントを発生させたオブジェクトid
- イベントを識別する整数。 許容される値については、ActionEvent
のクラスの説明を参照してください。command
- イベントに関連付ける1つのコマンド(または複数のコマンドのいずれか)を指定できる文字列modifiers
- イベント中に押された修飾キー(Shift、Ctrl、Alt、Meta)。 負の値のパラメータを渡すことはお薦めできません。 ゼロの値は修飾子が渡されなかったことを意味しますwhen
- イベントの発生時間を渡すlong値 負またはゼロの値を渡すことはお薦めできません- 例外:
IllegalArgumentException
-source
がnullである場合- 導入されたバージョン:
- 1.4
- 関連項目:
EventObject.getSource()
,AWTEvent.getID()
,getActionCommand()
,getModifiers()
,getWhen()
-
-
メソッドの詳細
-
getActionCommand
public String getActionCommand()このアクションに関連付けられたコマンド文字列を返します。 「モーダル」コンポーネントはこの文字列を使って、その状態に応じていくつかのコマンドのいずれかを指定できます。 たとえば、1つのボタンで「詳細を表示」と「詳細を隠す」を切り替えられます。 ソース・オブジェクトとイベントはどちらの場合も同じですが、コマンド文字列が意図されたアクションを識別します。null
コマンド文字列がこのActionEvent
のコンストラクタに渡されると、このメソッドはnull
を返します。- 戻り値:
- このイベントのコマンドを識別する文字列
-
getWhen
public long getWhen()このイベントが発生した時点のタイムスタンプを返します。 ActionEventが高レベルのセマンティック・イベントであるため、タイムスタンプは通常は基本となるInputEventと同じです。- 戻り値:
- このイベントのタイムスタンプ
- 導入されたバージョン:
- 1.4
-
getModifiers
public int getModifiers()このアクション・イベント中に押された修飾キーを返します。- 戻り値:
- 修飾子定数のビット単位論理和
-
paramString
public String paramString()このアクション・イベントを識別するパラメータ文字列を返します。 このメソッドは、イベント・ログの作成およびデバッグに便利です。- オーバーライド:
paramString
、クラス:AWTEvent
- 戻り値:
- イベントを識別する文字列とそれに関連付けられたコマンド
-