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 を取得します。したがって、リスナーはマウスの個々の動きやマウスクリックを個別に処理することなく、「項目が選択」または「選択解除された」ときに発生するイベントなどの「意味のある」イベントを処理します。

導入されたバージョン:

1.1

関連項目:

ItemSelectable, ItemListener, 「Tutorial: Writing an Item Listener」, 直列化された形式

フィールドの概要

static int	DESELECTED この状態変更値は、項目の選択解除を示します。
static int	ITEM_FIRST 項目イベント識別子の範囲を示す最初の番号です。
static int	ITEM_LAST 項目イベント識別子の範囲を示す最後の番号です。
static int	ITEM_STATE_CHANGED このイベント識別子は、項目の状態の変更を示します。
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

項目イベント識別子の範囲を示す最初の番号です。

関連項目:

定数フィールド値

ITEM_LAST

public static final int ITEM_LAST

項目イベント識別子の範囲を示す最後の番号です。

関連項目:

定数フィールド値

ITEM_STATE_CHANGED

public static final int ITEM_STATE_CHANGED

このイベント識別子は、項目の状態の変更を示します。

関連項目:

定数フィールド値

SELECTED

public static final int SELECTED

この状態変更値は、項目の選択を示します。

関連項目:

定数フィールド値

DESELECTED

public static final int DESELECTED

この状態変更値は、項目の選択解除を示します。

関連項目:

定数フィールド値

コンストラクタの詳細

ItemEvent

public ItemEvent(ItemSelectable source,
                 int id,
                 Object item,
                 int stateChange)

ItemEvent オブジェクトを構築します。

無効な id を渡して、特定できない動作を発生させないようにしてください。このメソッドは source が null の場合に IllegalArgumentException をスローします。

パラメータ:

source - イベントの発生元の ItemSelectable オブジェクト

id - イベントの型を特定する整数

item - オブジェクト、すなわち、イベントによって影響を受けた項目

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

例外:

IllegalArgumentException - source が null の場合

メソッドの詳細

getItemSelectable

public ItemSelectable getItemSelectable()

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

戻り値:

イベントの発生元の ItemSelectable オブジェクト

getItem

public Object getItem()

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

戻り値:

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

getStateChange

public int getStateChange()

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

戻り値:

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

関連項目:

SELECTED, DESELECTED

paramString

public String paramString()

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

オーバーライド:

クラス AWTEvent 内の paramString

戻り値:

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