JavaTM Platform
Standard Ed. 6

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 を渡して、特定できない動作を発生させないようにしてください。このメソッドは sourcenull の場合に 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
戻り値:
イベントを特定する文字列とその属性

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。