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

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

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

Поля

Модификатор и тип	Поле и описание
`static int`	`COMPONENT_ADDED` Это событие указывает, что компонент был добавлен в контейнер.
`static int`	`COMPONENT_REMOVED` Это событие указывает, что компонент был удален из контейнера.
`static int`	`CONTAINER_FIRST` Первое число в диапазоне идентификаторов, используемых для событий контейнера.
`static 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, 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.