モジュール java.desktop

パッケージ java.awt.event

クラスActionEvent

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	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

@Native
public static final int ACTION_PERFORMED

このイベントIDは、意味のあるアクションが発生したことを示します。

関連項目:

定数フィールド値

コンストラクタの詳細

ActionEvent

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

ActionEventオブジェクトを構築します。

このメソッドはsourceがnullの場合にIllegalArgumentExceptionをスローします。 null command文字列は誤りではありませんが、非推奨です。

パラメータ:

source - イベントを発生させたオブジェクト

id - イベントを識別する整数。 許容される値については、ActionEventのクラスの説明を参照してください。

command - イベントに関連付ける1つのコマンド(または複数のコマンドのいずれか)を指定できる文字列

例外:

IllegalArgumentException - sourceがnullである場合

関連項目:

EventObject.getSource(), AWTEvent.getID(), getActionCommand()

ActionEvent

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

修飾キーで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

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

指定された修飾キーとタイムスタンプで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

戻り値:

イベントを識別する文字列とそれに関連付けられたコマンド