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

Class ItemEvent

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

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

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

    任何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
        用于项目事件的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如果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
        结果
        标识事件及其属性的字符串