Spec-Zone.ru › OpenJDK 27

Класс ItemEvent

java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.ItemEvent
Все реализуемые интерфейсы:
Serializable
public class ItemEvent extends AWTEvent
Семантическое событие, указывающее, что элемент был выбран или отменён. Это высокоуровневое событие генерируется объектом ItemSelectable (например, списком), когда пользователь выбирает элемент или отменяет его выбор. Событие передаётся каждому объекту ItemListener, зарегистрированному для получения таких событий с помощью метода addItemListener компонента.

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

Если параметр id какого-либо экземпляра ItemEvent не находится в диапазоне от ITEM_FIRST до ITEM_LAST, поведение не определено.

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

  • ItemEvent.SELECTED
  • ItemEvent.DESELECTED
Присваивание значения, отличного от перечисленных выше, приводит к неопределённому поведению.
Начиная с версии:
1.1
См. также:
  • ItemSelectable
  • ItemListener
  • Руководство: написание слушателя элементов
  • Сериализованная форма

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

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

Поля, объявленные в классе 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
Модификатор и тип Поле Описание
static final long ACTION_EVENT_MASK
Маска событий для выбора событий действий.
static final long ADJUSTMENT_EVENT_MASK
Маска событий для выбора событий настройки.
static final long COMPONENT_EVENT_MASK
Маска событий для выбора событий компонентов.
protected boolean consumed
Определяет, будет ли событие отправлено обратно пиру после его обработки источником: значение false означает, что оно отправляется пиру; значение true — что не отправляется.
static final long CONTAINER_EVENT_MASK
Маска событий для выбора событий контейнеров.
static final long FOCUS_EVENT_MASK
Маска событий для выбора событий фокуса.
static final long HIERARCHY_BOUNDS_EVENT_MASK
Маска событий для выбора событий границ иерархии.
static final long HIERARCHY_EVENT_MASK
Маска событий для выбора событий иерархии.
protected int id
Идентификатор события.
static final long INPUT_METHOD_EVENT_MASK
Маска событий для выбора событий метода ввода.
static final long INVOCATION_EVENT_MASK
Маска событий для выбора событий вызова.
static final long ITEM_EVENT_MASK
Маска событий для выбора событий элементов.
static final long KEY_EVENT_MASK
Маска событий для выбора событий клавиатуры.
static final long MOUSE_EVENT_MASK
Маска событий для выбора событий мыши.
static final long MOUSE_MOTION_EVENT_MASK
Маска событий для выбора событий перемещения мыши.
static final long MOUSE_WHEEL_EVENT_MASK
Маска событий для выбора событий колеса мыши.
static final long PAINT_EVENT_MASK
Маска событий для выбора событий перерисовки.
static final int RESERVED_ID_MAX
Максимальное значение зарезервированных идентификаторов событий AWT.
static final long TEXT_EVENT_MASK
Маска событий для выбора текстовых событий.
static final long WINDOW_EVENT_MASK
Маска событий для выбора событий окон.
static final long WINDOW_FOCUS_EVENT_MASK
Маска событий для выбора событий фокуса окна.
static final long WINDOW_STATE_EVENT_MASK
Маска событий для выбора событий состояния окна.

Поля, объявленные в классе EventObject

source
Модификатор и тип Поле Описание
protected Object source
Объект, в котором изначально произошло событие.

Краткое описание конструкторов

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

Краткое описание методов

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

Методы, объявленные в классе AWTEvent

consume, getID, isConsumed, setSource, toString
Модификатор и тип Метод Описание
protected void consume()
Потребляет это событие, если его можно потребить.
int getID()
Возвращает тип события.
protected boolean isConsumed()
Возвращает признак того, было ли это событие потреблено.
void setSource(Object newSource)
Перенаправляет событие к новому источнику.
String toString()
Возвращает строковое представление этого объекта.

Методы, объявленные в классе EventObject

getSource
Модификатор и тип Метод Описание
Object getSource()
Объект, в котором изначально произошло событие.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создаёт и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли другой объект этому объекту.
protected void finalize()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Метод финализации устарел и подлежит удалению в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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
Возвращает:
строку, описывающую событие и его атрибуты

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API