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）產生的。該事件被傳遞到每個 ItemListener 物件，這些物件都已使用元件的 addItemListener 方法註冊接收此類別事件。

實作 ItemListener 介面的物件將在事件發生時獲取此 ItemEvent。偵聽器避開處理具體鼠標移動和鼠標單擊的細節問題，轉而處理諸如“已選定項”或“已取消選定項”之類別的“有意義的”（語義）事件。

從以下版本開始：

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 物件。

注意，傳遞無效 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

返回：

標識事件及其屬性的字元串