Spec-Zone.ru › OpenJDK 27

Класс ContainerEvent

java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.ComponentEvent
java.awt.event.ContainerEvent
Все реализуемые интерфейсы:
Serializable
public class ContainerEvent extends ComponentEvent
Низкоуровневое событие, указывающее на изменение содержимого контейнера в результате добавления или удаления компонента.

События контейнера предназначены ТОЛЬКО для уведомления; AWT автоматически обрабатывает изменения содержимого контейнера, чтобы программа работала правильно независимо от того, получает ли она эти события.

Это низкоуровневое событие создается объектом-контейнером (например, Panel) при добавлении в него компонента или удалении из него. Событие передается каждому объекту ContainerListener или ContainerAdapter, зарегистрированному для получения таких событий с помощью метода addContainerListener компонента. (Объекты ContainerAdapter реализуют интерфейс ContainerListener.) Каждый такой объект-слушатель получает это ContainerEvent при возникновении события.

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

Начиная с:
1.1
См. также:
  • ContainerAdapter
  • ContainerListener
  • Руководство: написание слушателя контейнера
  • Сериализованная форма

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

Модификатор и тип Поле Описание
static final int COMPONENT_ADDED
Это событие указывает, что компонент был добавлен в контейнер.
static final int COMPONENT_REMOVED
Это событие указывает, что компонент был удален из контейнера.
static final int CONTAINER_FIRST
Первое число в диапазоне идентификаторов, используемых для событий контейнера.
static final int CONTAINER_LAST
Последнее число в диапазоне идентификаторов, используемых для событий контейнера.

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

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN
Модификатор и тип Поле Описание
static final int COMPONENT_FIRST
Первое число в диапазоне идентификаторов, используемых для событий компонентов.
static final int COMPONENT_HIDDEN
Это событие указывает, что компонент стал невидимым.
static final int COMPONENT_LAST
Последнее число в диапазоне идентификаторов, используемых для событий компонентов.
static final int COMPONENT_MOVED
Это событие указывает, что положение компонента изменилось.
static final int COMPONENT_RESIZED
Это событие указывает, что размер компонента изменился.
static final int COMPONENT_SHOWN
Это событие указывает, что компонент стал видимым.

Поля, объявленные в классе 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
Объект, в котором первоначально произошло событие.

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

Конструктор Описание
ContainerEvent(Component source, int id, Component child)
Создает объект ContainerEvent.

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

Модификатор и тип Метод Описание
Component getChild()
Возвращает компонент, затронутый событием.
Container getContainer()
Возвращает источник события.
String paramString()
Возвращает строку параметров, идентифицирующую это событие.

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

getComponent
Модификатор и тип Метод Описание
Component getComponent()
Возвращает источник события.

Методы, объявленные в классе 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, либо до истечения заданного промежутка реального времени.

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

CONTAINER_FIRST

public static final int CONTAINER_FIRST
Первое число в диапазоне идентификаторов, используемых для событий контейнера.
См. также:
  • Значения константных полей

CONTAINER_LAST

public static final int CONTAINER_LAST
Последнее число в диапазоне идентификаторов, используемых для событий контейнера.
См. также:
  • Значения константных полей

COMPONENT_ADDED

public static final int COMPONENT_ADDED
Это событие указывает, что компонент был добавлен в контейнер.
См. также:
  • Значения константных полей

COMPONENT_REMOVED

public static final int COMPONENT_REMOVED
Это событие указывает, что компонент был удален из контейнера.
См. также:
  • Значения константных полей

Подробное описание конструкторов

ContainerEvent

public ContainerEvent(Component source, int id, Component child)
Создает объект ContainerEvent.

Этот метод вызывает IllegalArgumentException, если source равен null.

Параметры:
source — объект Component (контейнер), являющийся источником события
id — целое число, указывающее тип события. Допустимые значения см. в описании класса ContainerEvent
child — компонент, который был добавлен или удален
Исключения:
IllegalArgumentException — если source равно null
См. также:
  • getContainer()
  • AWTEvent.getID()
  • getChild()

Подробное описание методов

getContainer

public Container getContainer()
Возвращает источник события.
Возвращает:
объект Container, являющийся источником события, или null, если объект не является Container.

getChild

public Component getChild()
Возвращает компонент, затронутый событием.
Возвращает:
объект Component, который был добавлен или удален

paramString

public String paramString()
Возвращает строку параметров, идентифицирующую это событие. Этот метод полезен для ведения журнала событий и отладки.
Переопределяет:
paramString в классе ComponentEvent
Возвращает:
строку, идентифицирующую событие и его атрибуты

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по 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