モジュール java.desktop

パッケージ java.awt.event

クラス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

関連項目:

• ItemSelectable
• ItemListener
• チュートリアル: アイテム・リスナーの記述
• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
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	この状態変更値は、項目が選択されたことを示します。

クラス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

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

コンストラクタ

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

メソッドのサマリー

修飾子と型	メソッド	説明
Object	getItem()	イベントによって影響を受けた項目を返します。
ItemSelectable	getItemSelectable()	イベントの発生元を返します。
int	getStateChange()	状態変更のタイプ(選択または選択解除)を返します。
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

フィールド詳細

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()
• AWTEvent.getID()
• getStateChange()

メソッドの詳細

getItemSelectable

public ItemSelectable getItemSelectable()

イベントの発生元を返します。

戻り値:

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

getItem

public Object getItem()

イベントによって影響を受けた項目を返します。

戻り値:

イベントによって影響を受けた項目(オブジェクト)

getStateChange

public int getStateChange()

状態変更のタイプ(選択または選択解除)を返します。

戻り値:

項目が選択されたのか選択解除されたのかを示す整数

関連項目:

• SELECTED
• DESELECTED

paramString

public String paramString()

この項目イベントを特定するパラメータ文字列を返します。 このメソッドは、イベント・ログの作成およびデバッグに便利です。

オーバーライド:

paramString、クラスAWTEvent

戻り値:

イベントを特定する文字列とその属性