JavaTM 2 Platform
Standard Ed. 5.0

java.awt.event
类 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。侦听器避开处理具体鼠标移动和鼠标单击的细节问题,转而处理诸如“已选定项”或“已取消选定项”之类的“有意义的”(语义)事件。

从以下版本开始:
1.1
另请参见:
ItemSelectable, ItemListener, Tutorial: Writing an Item Listener, Reference: The Java Class Libraries (update file), 序列化表格

字段摘要
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 对象。

注意,传递无效 id 会导致不确定的行为。如果 sourcenull,则此方法抛出 IllegalArgumentException

参数:
source - 产生事件的 ItemSelectable 对象
id - 标识事件类型的整数
item - 一个对象,即受事件影响的项
stateChange - 指示已选定还是已取消选定项的整数
抛出:
IllegalArgumentException - 如果 source 为 null
方法详细信息

getItemSelectable

public ItemSelectable getItemSelectable()
返回事件的产生程序。

返回:
产生事件的 ItemSelectable 对象。

getItem

public Object getItem()
返回受事件影响的项。

返回:
受事件影响的项(对象)

getStateChange

public int getStateChange()
返回状态更改的类型(已选定或已取消选定)。

返回:
指示已选定还是已取消选定项的整数
另请参见:
SELECTED, DESELECTED

paramString

public String paramString()
返回标识此项事件的参数字符串。此方法对事件日志记录和调试很有用。

覆盖:
AWTEvent 中的 paramString
返回:
标识事件及其属性的字符串

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策