- 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.util.EventObject
getSource
-
-
-
-
字段详细信息
-
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
- 结果
- 标识事件及其属性的字符串
-
-