Класс ItemEvent

java.lang.Object
- java.util.EventObject
- - java.awt.AWTEvent
  - - java.awt.event.ItemEvent

Все реализованные интерфейсы:: Serializable

public class ItemEvent
extends AWTEvent

Семантическое событие, указывающее, что элемент был выбран или отменен. Это событие высокого уровня генерируется объектом ItemSelectable (таким как List), когда пользователь выбирает или отменяет выбор элемента. Событие передаётся каждому объекту, который зарегистрирован для получения таких событий с помощью метода компонента addItemListener.

Объект, реализующий интерфейс ItemListener, получает это ItemEvent, когда происходит событие. Прослушивателю не нужно обрабатывать подробности обработки отдельных движений и щелчков мыши, вместо этого он может обрабатывать «значимое» (семантическое) событие, такое как «элемент выбран» или «элемент снят с выбора».

Неопределённое поведение будет вызвано, если параметр id любого экземпляра ItemEvent не находится в диапазоне от ITEM_FIRST до ITEM_LAST.

Значение stateChange любого экземпляра ItemEvent принимает одно из следующих значений:

ItemEvent.SELECTED
ItemEvent.DESELECTED

Присвоение значения, отличного от перечисленных выше, вызовет неопределённое поведение.

С тех пор:: 1.1
См. также:: ItemSelectable, ItemListener, Учебник: Написание прослушивателя событий выбора, Сериализованная форма

Поля

Модификатор и тип	Поле и описание
`static int`	`DESELECTED` Это значение изменения состояния указывает, что выбранный элемент был снят с выбора.
`static int`	`ITEM_FIRST` Первое число в диапазоне идентификаторов, используемых для событий выбора.
`static int`	`ITEM_LAST` Последнее число в диапазоне идентификаторов, используемых для событий выбора.
`static int`	`ITEM_STATE_CHANGED` Этот идентификатор события указывает, что состояние элемента изменилось.
`static int`	`SELECTED` Это значение изменения состояния указывает, что элемент был выбран.

Поля, унаследованные от класса java.awt.AWTEvent

ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK

Поля, унаследованные от класса java.util.EventObject

source

Конструкторы

Конструктор и описание
`ItemEvent(ItemSelectable source, int id, Object item, int stateChange)` Создаёт объект `ItemEvent`.

Методы

Модификатор и тип	Метод и описание
`Object`	`getItem()` Возвращает элемент, затронутый событием.
`ItemSelectable`	`getItemSelectable()` Возвращает источник события.
`int`	`getStateChange()` Возвращает тип изменения состояния (выбран или снят с выбора).
`String`	`paramString()` Возвращает строку параметров, идентифицирующую это событие выбора.

Методы, унаследованные от класса java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Методы, унаследованные от класса java.util.EventObject

getSource

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание полей

ITEM_FIRST

public static final int ITEM_FIRST

Первое число в диапазоне идентификаторов, используемых для событий выбора.

См. также:: Значения константных полей

ITEM_LAST

public static final int ITEM_LAST

Последнее число в диапазоне идентификаторов, используемых для событий выбора.

См. также:: Значения константных полей

ITEM_STATE_CHANGED

public static final int ITEM_STATE_CHANGED

Этот идентификатор события указывает, что состояние элемента изменилось.

См. также:: Значения константных полей

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 равен null
См. также:: 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
Возвращает:: строка, идентифицирующая событие и его атрибуты

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.