- 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
。 监听器免除处理单个鼠标移动和鼠标点击的细节,并且可以代替处理“有意义的”(语义)事件,如“选择项目”或“取消选择项目”。如果任何特定的
ItemEvent
实例的id
参数不在从ITEM_FIRST
到ITEM_LAST
的范围内,将会导致未指定的行为。任何
ItemEvent
实例的stateChange
都需要以下值之一:-
ItemEvent.SELECTED
-
ItemEvent.DESELECTED
- 从以下版本开始:
- 1.1
- 另请参见:
-
ItemSelectable
,ItemListener
, Tutorial: Writing an Item Listener , Serialized Form
-
-
Field Summary
Fields Modifier and Type Field 描述 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 描述 ItemEvent(ItemSelectable source, int id, Object item, int stateChange)
构造一个ItemEvent
对象。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 Object
getItem()
返回受事件影响的项目。ItemSelectable
getItemSelectable()
返回事件的发起者。int
getStateChange()
返回状态更改的类型(选择或取消选择)。String
paramString()
返回标识此项事件的参数字符串。-
Methods inherited from class java.util.EventObject
getSource
-
-
-
-
字段详细信息
-
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
- 结果
- 标识事件及其属性的字符串
-
-