Spec-Zone.ru › OpenJDK 24

Класс 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
Последнее число в диапазоне идентификаторов, используемых для событий контейнера.

Поля, объявленные в классе java.awt.event.ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Поля, объявленные в классе 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

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

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

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

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

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

getComponent

Методы, объявленные в классе 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

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

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

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/event/ContainerEvent.html

Spec-Zone.ru

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