モジュール 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, 直列化された形式

  • フィールド詳細

    • 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
      戻り値:
      イベントを識別する文字列とそれに関連付けられたコマンド