クラスItemEvent

java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.ItemEvent
すべての実装されたインタフェース:
Serializable
public class ItemEvent extends AWTEvent
項目が選択または選択解除されたことを示すセマンティック・イベントです。 この高レベル・イベントは、ユーザーによって項目が選択または選択解除されたときに、ItemSelectableオブジェクト(Listなど)によって生成されます。 イベントは、そのコンポーネントのaddItemListenerメソッドを使って、これらのイベントを受け取るように登録されているすべてのItemListenerオブジェクトに渡されます。

ItemListenerインタフェースを実装するオブジェクトは、イベントが発生したときにこのItemEventを取得します。 リスナーは、個々のマウス移動やマウス・クリックを個別に処理することなく、「項目が選択された」や「項目が選択解除された」などの「意味のある(セマンティック)」イベントを処理できます。

特定のItemEventインスタンスのidパラメータがITEM_FIRSTからITEM_LASTまでの範囲にない場合に、未指定の動作が発生します。

ItemEventインスタンスのstateChangeは次のいずれかの値をとります。

  • ItemEvent.SELECTED
  • ItemEvent.DESELECTED
上記以外の値を割り当てると、未指定の動作が発生します。

導入されたバージョン:
1.1
関連項目:

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final int
    DESELECTED
    この状態変更値は、選択された項目が選択解除されたことを示します。
    static final int
    ITEM_FIRST
    項目イベントに使用されるIDの範囲内の最初の番号です。
    static final int
    ITEM_LAST
    項目イベントに使用されるIDの範囲内の最後の番号です。
    static final int
    ITEM_STATE_CHANGED
    このイベントIDは、項目の状態が変更されたことを示します。
    static final int
    SELECTED
    この状態変更値は、項目が選択されたことを示します。

    クラスで宣言されたフィールド 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が最初に発生したオブジェクト。

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

    コンストラクタ
    コンストラクタ
    説明
    ItemEvent(ItemSelectable source, int id, Object item, int stateChange)
    ItemEventオブジェクトを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    Object
    getItem()
    イベントによって影響を受けた項目を返します。
    ItemSelectable
    getItemSelectable()
    イベントの発生元を返します。
    int
    getStateChange()
    状態変更のタイプ(選択または選択解除)を返します。
    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であるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • ITEM_FIRST

      public static final int ITEM_FIRST
      項目イベントに使用されるIDの範囲内の最初の番号です。
      関連項目:

    • ITEM_LAST

      public static final int ITEM_LAST
      項目イベントに使用されるIDの範囲内の最後の番号です。
      関連項目:

    • ITEM_STATE_CHANGED

      public static final int ITEM_STATE_CHANGED
      このイベントIDは、項目の状態が変更されたことを示します。
      関連項目:

    • SELECTED

      public static final int SELECTED
      この状態変更値は、項目が選択されたことを示します。
      関連項目:

    • DESELECTED

      public static final int DESELECTED
      この状態変更値は、選択された項目が選択解除されたことを示します。
      関連項目:

  • コンストラクタの詳細

    • ItemEvent

      public ItemEvent(ItemSelectable source, int id, Object item, int stateChange)
      ItemEventオブジェクトを構築します。

      このメソッドはsourceがnullの場合にIllegalArgumentExceptionをスローします。

      パラメータ:
      source - イベントを発生させたItemSelectableオブジェクト
      id - イベント・タイプを識別する整数。 許容される値については、ItemEventのクラスの説明を参照してください。
      item - オブジェクト -- イベントによって影響を受けた項目
      stateChange - 項目が選択されたのか選択解除されたのかを示す整数 許容される値については、ItemEventのクラスの説明を参照してください。
      スロー:
      IllegalArgumentException - sourceがnullである場合
      関連項目:

  • メソッドの詳細

    • getItemSelectable

      public ItemSelectable getItemSelectable()
      イベントの発生元を返します。
      戻り値:
      イベントを発生させたItemSelectableオブジェクト

    • getItem

      public Object getItem()
      イベントによって影響を受けた項目を返します。
      戻り値:
      イベントによって影響を受けた項目(オブジェクト)

    • getStateChange

      public int getStateChange()
      状態変更のタイプ(選択または選択解除)を返します。
      戻り値:
      項目が選択されたのか選択解除されたのかを示す整数
      関連項目:

    • paramString

      public String paramString()
      この項目イベントを特定するパラメータ文字列を返します。 このメソッドは、イベント・ログの作成およびデバッグに便利です。
      オーバーライド:
      paramString、クラスAWTEvent
      戻り値:
      イベントを特定する文字列とその属性