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, Tutorial: Writing an Item Listener, 直列化された形式

フィールドのサマリー

フィールド

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

戻り値:

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