模块 java.desktop
包 java.awt.event

类 ItemEvent

java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.ItemEvent
所有已实现的接口：
Serializable
public class ItemEvent extends AWTEvent
指示选择或取消选择项目的语义事件。当用户选择或取消选择项目时，此高级事件由 ItemSelectable 对象（例如列表）生成。该事件被传递给每个注册为使用组件的 addItemListener 方法接收此类事件的 ItemListener 对象。

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

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

任何 ItemEvent 实例的 stateChange 都采用以下值之一：

  • ItemEvent.SELECTED
  • ItemEvent.DESELECTED
分配与上面列出的不同的值将导致未指定的行为。
自从：
1.1
参见：

  • 字段详细信息

    • 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 对象.

      如果 source 是 null，此方法将抛出 IllegalArgumentException。

      参数：
      source - 发起事件的 ItemSelectable 对象
      id - 标识事件类型的整数。有关允许值的信息，请参阅 ItemEvent 的类描述
      item - 一个对象——受事件影响的项目
      stateChange - 一个整数，指示该项是被选中还是被取消选中。有关允许值的信息，请参阅 ItemEvent 的类描述
      抛出：
      IllegalArgumentException - 如果 source 为空
      参见：

  • 方法详情

    • getItemSelectable

      public ItemSelectable  getItemSelectable()
      返回事件的发起者。
      返回：
      发起事件的 ItemSelectable 对象。

    • getItem

      public Object  getItem()
      返回受事件影响的项目。
      返回：
      受事件影响的项目（对象）

    • getStateChange

      public int getStateChange()
      返回状态更改的类型（选中或取消选中）。
      返回：
      一个整数，指示该项是被选中还是被取消选中
      参见：

    • paramString

      public String  paramString()
      返回标识此项目事件的参数字符串。此方法对于事件记录和调试很有用。
      重写：
      paramString 在类 AWTEvent 中
      返回：
      标识事件及其属性的字符串