Класс ComponentEvent

java.awt.event.ComponentEvent

Все реализуемые интерфейсы:: Serializable

Прямые известные подклассы:: ContainerEvent, FocusEvent, InputEvent, PaintEvent, WindowEvent

public class ComponentEvent extends AWTEvent

Низкоуровневое событие, указывающее, что компонент переместился, изменил размер или видимость (также является корневым классом для других событий, связанных с компонентами).

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

Помимо того, что этот класс служит базовым для других событий, связанных с компонентами (InputEvent, FocusEvent, WindowEvent, ContainerEvent), он определяет события, указывающие на изменения размера, положения или видимости компонента.

Это низкоуровневое событие создается объектом компонента (например, List), когда компонент перемещается, изменяет размер, становится невидимым или снова становится видимым. Событие передается каждому объекту ComponentListener или ComponentAdapter, зарегистрированному для получения таких событий с помощью метода addComponentListener компонента. (Объекты ComponentAdapter реализуют интерфейс ComponentListener.) Каждый такой объект-получатель получает это ComponentEvent при возникновении события.

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

Начиная с версии:

1.1

См. также:

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

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

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

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

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

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

Методы, объявленные в классе 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 или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания, либо до истечения заданного времени.

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

COMPONENT_FIRST

public static final int COMPONENT_FIRST

Первое число в диапазоне идентификаторов, используемых для событий компонентов.

См. также:

COMPONENT_LAST

public static final int COMPONENT_LAST

Последнее число в диапазоне идентификаторов, используемых для событий компонентов.

См. также:

COMPONENT_MOVED

@Native public static final int COMPONENT_MOVED

Это событие указывает, что положение компонента изменилось.

См. также:

COMPONENT_RESIZED

@Native public static final int COMPONENT_RESIZED

Это событие указывает, что размер компонента изменился.

См. также:

COMPONENT_SHOWN

@Native public static final int COMPONENT_SHOWN

Это событие указывает, что компонент стал видимым.

См. также:

COMPONENT_HIDDEN

@Native public static final int COMPONENT_HIDDEN

Это событие указывает, что компонент стал невидимым.

См. также:

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

ComponentEvent

public ComponentEvent(Component source, int id)

Создает объект ComponentEvent.

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

Параметры:

source — Component, породивший событие

id — целое число, указывающее тип события. Допустимые значения см. в описании класса ComponentEvent

Выбрасывает:

IllegalArgumentException — если source имеет значение null

См. также:

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

getComponent

public Component getComponent()

Возвращает источник события.

Возвращает:: объект Component, породивший событие, или null, если объект не является Component.

paramString

public String paramString()

Возвращает строку параметров, идентифицирующую это событие. Этот метод полезен для ведения журнала событий и отладки.

Переопределяет:: paramString в классе AWTEvent
Возвращает:: строку, идентифицирующую событие и его атрибуты

© 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.