模块 java.desktop

软件包 java.awt.event

Class 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 。 监听器不需要处理单个鼠标移动和鼠标点击的细节，而是可以处理“有意义的”（语义）事件，如“选择项目”或“取消选择项目”。

如果任何特定ItemEvent实例的id参数不在ITEM_FIRST到ITEM_LAST范围内， ITEM_FIRST导致未指定的行为。

任何ItemEvent实例的stateChange都采用以下值之一：

• ItemEvent.SELECTED
• ItemEvent.DESELECTED

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

从以下版本开始：

1.1

另请参见：

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

字段汇总

字段

变量和类型	字段	描述
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对象。

此方法抛出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

结果

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