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_FIRST到ITEM_LAST的范围内，将会导致未指定的行为。

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

    • ItemEvent.SELECTED
    • ItemEvent.DESELECTED
    分配与上述不同的值将导致未指定的行为。
    从以下版本开始：
    1.1
    另请参见：
    ItemSelectable ， ItemListener ， Tutorial: Writing an Item Listener ， Serialized 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如果source为null 。

        参数
        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​()
        返回状态更改的类型（选择或取消选择）。
        结果
        一个整数，表示该项目是被选中还是被取消选择
        另请参见：
        SELECTED ， DESELECTED

      • paramString

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