Module java.desktop

Package 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）生成。事件传递给每个使用组件的addItemListener方法注册接收此类事件的ItemListener对象。

实现ItemListener接口的对象在事件发生时会收到ItemEvent。监听器无需处理单个鼠标移动和鼠标点击的细节，而是可以处理“有意义”的（语义的）事件，如“项目已选择”或“项目已取消选择”。

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

任何ItemEvent实例的stateChange取以下值之一:

• ItemEvent.SELECTED
• ItemEvent.DESELECTED

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

自:

1.1

参见:

• ItemSelectable
• ItemListener
• 教程: 编写Item监听器
• 序列化形式

Field Summary

Fields

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

Fields declared in 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 declared in class java.util.EventObject

source

Constructor Summary

Constructors

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

Method Summary

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

Methods declared in class java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Methods declared in class java.util.EventObject

getSource

Methods declared in class java.lang.Object

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

Field Details

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
            

此状态更改值表示取消选择已选择的项目。

参见:

• 常量字段值

Constructor Details

ItemEvent

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

构造一个ItemEvent对象。

如果source为null，则此方法会抛出IllegalArgumentException。

参数:

source - 产生事件的ItemSelectable对象

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

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

stateChange - 一个整数，指示项目是已选择还是已取消选择。有关允许值的信息，请参阅ItemEvent类描述

抛出:

IllegalArgumentException - 如果source为null

参见:

• getItemSelectable()
• AWTEvent.getID()
• getStateChange()

Method Details

getItemSelectable

             public ItemSelectable getItemSelectable()
            

返回事件的发起者。

返回:

产生事件的ItemSelectable对象。

getItem

             public Object getItem()
            

返回受事件影响的项目。

返回:

受事件影响的项目（对象）。

getStateChange

             public int getStateChange()
            

返回状态更改的类型（已选择或已取消选择）。

返回:

一个整数，指示项目是已选择还是已取消选择。

参见:

• SELECTED
• DESELECTED

paramString

             public String paramString()
            

返回标识此项目事件的参数字符串。此方法对于事件记录和调试很有用。

覆盖:

paramString 在类 AWTEvent

返回:

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