Module  java.desktop
软件包  java.awt.event

Class ItemEvent

  • All Implemented Interfaces:
    Serializable


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

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

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

    任何ItemEvent实例的stateChange都需要以下值之一:

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

      • 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如果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​()
        返回标识此项事件的参数字符串。 此方法对于事件记录和调试很有用。
        重写:
        paramStringAWTEvent
        结果
        标识事件及其属性的字符串