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

関連項目:

フィールドのサマリー

フィールド

修飾子と型

フィールド

説明

static final int

ACTION_FIRST

アクション・イベントに使用されるIDの範囲内の最初の番号です。

static final int

ACTION_LAST

アクション・イベントに使用されるIDの範囲内の最後の番号です。

static final int

ACTION_PERFORMED

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

static final int

ALT_MASK

Alt修飾子です。

static final int

CTRL_MASK

Ctrl修飾子です。

static final int

META_MASK

Meta修飾子です。

static final int

SHIFT_MASK

Shift修飾子です。

クラスで宣言されたフィールド 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

修飾子と型

フィールド

説明

static final long

ACTION_EVENT_MASK

アクション・イベント選択用イベント・マスクです。

static final long

ADJUSTMENT_EVENT_MASK

調整イベント選択用イベント・マスクです。

static final long

COMPONENT_EVENT_MASK

コンポーネント・イベント選択用イベント・マスクです。

protected boolean

consumed

転送元の処理後にイベントをピアに送り返すかどうかを制御します。trueの場合は送り返されず、falseの場合は送り返されます。

static final long

CONTAINER_EVENT_MASK

コンテナ・イベント選択用イベント・マスクです。

static final long

FOCUS_EVENT_MASK

フォーカス・イベント選択用イベント・マスクです。

static final long

HIERARCHY_BOUNDS_EVENT_MASK

階層境界イベント選択用イベント・マスクです。

static final long

HIERARCHY_EVENT_MASK

階層イベント選択用イベント・マスクです。

protected int

id

イベントのID

static final long

INPUT_METHOD_EVENT_MASK

インプット・メソッド・イベント選択用イベント・マスクです。

static final long

INVOCATION_EVENT_MASK

呼出しイベント選択用イベント・マスクです。

static final long

ITEM_EVENT_MASK

項目イベント選択用イベント・マスクです。

static final long

KEY_EVENT_MASK

キー・イベント選択用イベント・マスクです。

static final long

MOUSE_EVENT_MASK

マウス・イベント選択用イベント・マスクです。

static final long

MOUSE_MOTION_EVENT_MASK

マウス・モーション・イベント選択用イベント・マスクです。

static final long

MOUSE_WHEEL_EVENT_MASK

マウス・ホイール・イベント選択用イベント・マスクです。

static final long

PAINT_EVENT_MASK

ペイント・イベント選択用イベント・マスクです。

static final int

RESERVED_ID_MAX

予約済みAWTイベントIDの最大値です。

static final long

TEXT_EVENT_MASK

テキスト・イベント選択用イベント・マスクです。

static final long

WINDOW_EVENT_MASK

ウィンドウ・イベント選択用イベント・マスクです。

static final long

WINDOW_FOCUS_EVENT_MASK

ウィンドウ・フォーカス・イベント選択用イベント・マスクです。

static final long

WINDOW_STATE_EVENT_MASK

ウィンドウ状態イベント選択用イベント・マスクです。

クラスで宣言されたフィールド EventObject
source

修飾子と型

フィールド

説明

protected Object

source

Eventが最初に発生したオブジェクト。
コンストラクタのサマリー

コンストラクタ

コンストラクタ

説明

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

このアクション・イベントを識別するパラメータ文字列を返します。

クラスで宣言されたメソッド AWTEvent
consume, getID, isConsumed, setSource, toString

修飾子と型

メソッド

説明

protected void

consume()

このイベントを消費できる場合は消費します。

int

getID()

イベント・タイプを返します。

protected boolean

isConsumed()

このイベントが消費されたかどうかを返します。

void

setSource(Object newSource)

イベントを新しいソースにターゲット変更します。

String

toString()

このオブジェクトの文字列表現を返します。

クラスで宣言されたメソッド EventObject
getSource

修飾子と型

メソッド

説明

Object

getSource()

Eventが最初に発生したオブジェクト。

クラスオブジェクトで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

修飾子と型

メソッド

説明

protected Object

clone()

このオブジェクトのコピーを作成して、返します。

boolean

equals(Object obj)

このオブジェクトと他のオブジェクトが等しいかどうかを示します。

protected void

finalize()

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
最終決定は非推奨であり、将来のリリースで削除される可能性があります。

final Class<?>

getClass()

このObjectの実行時クラスを返します。

int

hashCode()

このオブジェクトに対するハッシュ・コード値を返します。

final void

notify()

このオブジェクトのモニターで待機中のスレッドを1つ再開します。

final void

notifyAll()

このオブジェクトのモニターで待機中のすべてのスレッドを再開します。

final void

wait()

現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。

final void

wait(long timeoutMillis)

現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

final void

wait(long timeoutMillis, int nanos)

現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

フィールド詳細
- 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つのコマンド(または複数のコマンドのいずれか)を指定できる文字列
  
  when - イベントの発生時間を渡すlong値負またはゼロの値を渡すことはお薦めできません
  
  modifiers - イベント中に押された修飾キー(Shift、Ctrl、Alt、Meta)。負の値のパラメータを渡すことはお薦めできません。ゼロの値は修飾子が渡されなかったことを意味します
  
  スロー:
  
  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
  
  戻り値:
  
  イベントを識別する文字列とそれに関連付けられたコマンド

クラスActionEvent

フィールドのサマリー

クラスで宣言されたフィールド AWTEvent

クラスで宣言されたフィールド EventObject

コンストラクタのサマリー

メソッドのサマリー

クラスで宣言されたメソッド AWTEvent

クラスで宣言されたメソッド EventObject

クラスオブジェクトで宣言されたメソッド

フィールド詳細

SHIFT_MASK

CTRL_MASK

META_MASK

ALT_MASK

ACTION_FIRST

ACTION_LAST

ACTION_PERFORMED

コンストラクタの詳細

ActionEvent

ActionEvent

ActionEvent

メソッドの詳細

getActionCommand

getWhen

getModifiers

paramString