Spec-Zone.ru › OpenJDK 25

Класс 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

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

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

source

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

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

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

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

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

getComponent

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

consume, getID, isConsumed, setSource, toString

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

getSource

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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/event/ContainerEvent.html

Spec-Zone.ru

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