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