モジュール java.desktop
パッケージ 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
        戻り値:
        イベントを識別する文字列とそれに関連付けられたコマンド