java.awt.event

Class ItemEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.ItemEvent

All Implemented Interfaces:

Serializable

public class ItemEvent
extends AWTEvent

表示选择或取消选择项目的语义事件。 当用户选择或取消选择项目时，此高级事件由ItemSelectable对象（例如List）生成。 该事件传递给使用组件的addItemListener方法注册接收此类事件的每个ItemListener对象。

当事件发生时，实现ItemListener接口的对象获得此ItemEvent 。 监听器免除处理单个鼠标移动和鼠标点击的细节，并且可以代替处理“有意义的”（语义）事件，如“选择项目”或“取消选择”。

如果未指定的行为将引起id任何特定的参数ItemEvent实例不在范围从ITEM_FIRST到ITEM_LAST 。

该stateChange任何ItemEvent例如采用下列值之一：

• ItemEvent.SELECTED
• ItemEvent.DESELECTED

分配与上述不同的值将导致未指定的行为。

从以下版本开始：

1.1

另请参见：

ItemSelectable ， ItemListener ， Tutorial: Writing an Item Listener ， Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	DESELECTED 该状态变化值表示已选择的项目被取消选择。
static int	ITEM_FIRST 用于项目事件的ids范围中的第一个数字。
static int	ITEM_LAST 用于项目事件的ID的范围中的最后一个数字。
static int	ITEM_STATE_CHANGED 此事件id表示项目状态已更改。
static int	SELECTED 此状态变化值表示已选择项目。

Fields inherited from class 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

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
ItemEvent(ItemSelectable source, int id, Object item, int stateChange) 构造一个 ItemEvent对象。

方法摘要

Modifier and Type	Method and Description
Object	getItem() 返回受事件影响的项目。
ItemSelectable	getItemSelectable() 返回事件的发起者。
int	getStateChange() 返回状态更改的类型（选择或取消选择）。
String	paramString() 返回标识此项事件的参数字符串。

Methods inherited from class java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

ITEM_FIRST

public static final int ITEM_FIRST

用于项目事件的ids范围中的第一个数字。

另请参见：

Constant Field Values

ITEM_LAST

public static final int ITEM_LAST

用于项目事件的ID的范围中的最后一个数字。

另请参见：

Constant Field Values

ITEM_STATE_CHANGED

public static final int ITEM_STATE_CHANGED

此事件id表示项目状态已更改。

另请参见：

Constant Field Values

SELECTED

public static final int SELECTED

此状态变化值表示已选择项目。

另请参见：

Constant Field Values

DESELECTED

public static final int DESELECTED

该状态变化值表示已选择的项目被取消选择。

另请参见：

Constant Field Values

构造方法详细信息

ItemEvent

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

构造一个ItemEvent对象。

此方法抛出IllegalArgumentException如果source是null 。

参数

source - 发起事件的 ItemSelectable对象

id - 标识事件类型的整数。 有关允许值的信息，请参阅ItemEvent的类说明

item - 一个对象 - 受事件影响的项目

stateChange - 一个整数，指示项目是否被选中或取消选择。 有关允许值的信息，请参阅ItemEvent的类说明

异常

IllegalArgumentException - 如果 source为空

另请参见：

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

结果

标识事件及其属性的字符串