Класс ItemEvent

java.awt.event.ItemEvent

Все реализуемые интерфейсы:: Serializable

public class ItemEvent extends AWTEvent

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

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

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

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

ItemEvent.SELECTED
ItemEvent.DESELECTED

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

С тех пор:

1.1

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`DESELECTED`	Это значение изменения состояния указывает, что выделенный элемент был деактивирован.
`static final int`	`ITEM_FIRST`	Первое число в диапазоне идентификаторов, используемых для событий элементов.
`static final int`	`ITEM_LAST`	Последнее число в диапазоне идентификаторов, используемых для событий элементов.
`static final int`	`ITEM_STATE_CHANGED`	Этот идентификатор события указывает, что состояние элемента изменилось.
`static final 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, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/event/ItemEvent.html