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对象生成的（如表）当一个项目是由用户选择或取消选择。事件传递到每一个 ItemListener对象注册到使用组件的 addItemListener方法接收这样的事件。

实现ItemListener接口获取这ItemEvent事件发生时的对象。听者不处理单个鼠标移动和鼠标点击的细节，可以替代过程中的一个“有意义的”（语义）的事件如“选项”或“项目取消”。

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

任何ItemEvent实例的stateChange取下列值之一：

• ItemEvent.SELECTED
• ItemEvent.DESELECTED

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

从以下版本开始：

一点一

另请参见：

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 用于项目事件的入侵检测系统的第一个数字。
static int	ITEM_LAST 用于项目事件的入侵检测范围的最后一个数字。
static int	ITEM_STATE_CHANGED 此事件表示一个项目的状态更改。
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

Field Detail

ITEM_FIRST

public static final int ITEM_FIRST

用于项目事件的入侵检测系统的第一个数字。

另请参见：

Constant Field Values

ITEM_LAST

public static final int ITEM_LAST

用于项目事件的入侵检测范围的最后一个数字。

另请参见：

Constant Field Values

ITEM_STATE_CHANGED

public static final int ITEM_STATE_CHANGED

此事件表示一个项目的状态更改。

另请参见：

Constant Field Values

SELECTED

public static final int SELECTED

此状态更改值指示一个项目被选中。

另请参见：

Constant Field Values

DESELECTED

public static final int DESELECTED

这种状态的变化值表示所选项目被取消。

另请参见：

Constant Field Values

Constructor Detail

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

结果

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