模块  java.desktop
软件包  java.awt.event

Class ItemEvent

  • 实现的所有接口
    Serializable

    public class ItemEvent
    extends AWTEvent
    一个语义事件,指示已选择或取消选择某个项目。 当用户选择或取消选择项目时,此高级事件由ItemSelectable对象(例如List)生成。 事件将传递给每个ItemListener对象,该对象使用组件的addItemListener方法注册接收此类事件。

    事件发生时,实现ItemListener接口的对象获取此ItemEvent 监听器不需要处理单个鼠标移动和鼠标点击的细节,而是可以处理“有意义的”(语义)事件,如“选择项目”或“取消选择项目”。

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

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

    • ItemEvent.SELECTED
    • ItemEvent.DESELECTED
    分配与上面列出的值不同的值将导致未指定的行为。
    从以下版本开始:
    1.1
    另请参见:
    ItemSelectableItemListenerTutorial: Writing an Item ListenerSerialized Form
    • 字段详细信息

      • 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如果sourcenull

        参数
        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()
        返回状态更改的类型(已选中或已取消选择)。
        结果
        一个整数,指示是选择还是取消选择该项目
        另请参见:
        SELECTEDDESELECTED
      • paramString

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