ItemEvent

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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, 序列化表格

字段摘要
`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.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

此状态更改值指示已选定的项被取消选定。

另请参见：: 常量字段值

构造方法详细信息

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

构造一个 ItemEvent 对象。

注意，传递无效 id 会导致不确定的行为。如果 source 为 null，则此方法抛出 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

返回：: 标识事件及其属性的字符串

概述