Spec-Zone.ru › OpenJDK 27

Класс HierarchyEvent

java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.HierarchyEvent
Все реализованные интерфейсы:
Serializable
public class HierarchyEvent extends AWTEvent
Событие, указывающее на изменение иерархии Component, к которой относится Component.
  • События изменения иерархии (HierarchyListener)
    • добавление предка
    • удаление предка
    • иерархия стала доступной для отображения
    • иерархия перестала быть доступной для отображения
    • иерархия отображается на экране (видима и доступна для отображения)
    • иерархия скрыта на экране (невидима или недоступна для отображения)
  • События изменения размеров и положения предка (HierarchyBoundsListener)
    • размер предка был изменён
    • положение предка было изменено

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

Это событие генерируется объектом Container (например, Panel), когда Container добавляется, удаляется, перемещается или изменяет размер, и передаётся вниз по иерархии. Оно также генерируется объектом Component при вызове методов addNotify, removeNotify, show или hide этого объекта. События ANCESTOR_MOVED и ANCESTOR_RESIZED отправляются каждому объекту HierarchyBoundsListener или HierarchyBoundsAdapter, зарегистрированному для получения таких событий с помощью метода addHierarchyBoundsListener компонента. (Объекты HierarchyBoundsAdapter реализуют интерфейс HierarchyBoundsListener.) События HIERARCHY_CHANGED отправляются каждому объекту HierarchyListener, зарегистрированному для получения таких событий с помощью метода addHierarchyListener компонента. Каждый такой объект-слушатель получает это HierarchyEvent при возникновении события.

Если параметр id конкретного экземпляра HierarchyEvent не находится в диапазоне от HIERARCHY_FIRST до HIERARCHY_LAST, поведение не определено.
Параметр changeFlags любого экземпляра HierarchyEvent принимает одно из следующих значений:

  • HierarchyEvent.PARENT_CHANGED
  • HierarchyEvent.DISPLAYABILITY_CHANGED
  • HierarchyEvent.SHOWING_CHANGED
Присваивание значения, отличного от перечисленных выше, приводит к неопределённому поведению.
Начиная с версии:
1.3
См. также:
  • HierarchyListener
  • HierarchyBoundsAdapter
  • HierarchyBoundsListener
  • Сериализованная форма

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

Модификатор и тип Поле Описание
static final int ANCESTOR_MOVED
Идентификатор события, указывающий на перемещение предка-Container.
static final int ANCESTOR_RESIZED
Идентификатор события, указывающий на изменение размера предка-Container.
static final int DISPLAYABILITY_CHANGED
Флаг изменения указывает, что событие HIERARCHY_CHANGED было сгенерировано из-за изменения доступности иерархии для отображения.
static final int HIERARCHY_CHANGED
Идентификатор события, указывающий на изменение всего дерева иерархии.
static final int HIERARCHY_FIRST
Обозначает первый целочисленный идентификатор диапазона идентификаторов событий иерархии.
static final int HIERARCHY_LAST
Обозначает последний целочисленный идентификатор диапазона идентификаторов событий предков.
static final int PARENT_CHANGED
Флаг изменения указывает, что событие HIERARCHY_CHANGED было сгенерировано операцией смены родителя.
static final int SHOWING_CHANGED
Флаг изменения указывает, что событие HIERARCHY_CHANGED было сгенерировано из-за изменения состояния отображения иерархии.

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

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

Конструктор Описание
HierarchyEvent(Component source, int id, Component changed, Container changedParent)
Создаёт объект HierarchyEvent для обозначения изменения иерархии Component.
HierarchyEvent(Component source, int id, Component changed, Container changedParent, long changeFlags)
Создаёт объект HierarchyEvent для обозначения изменения иерархии Component.

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

Модификатор и тип Метод Описание
Component getChanged()
Возвращает компонент в верхней части изменённой иерархии.
Container getChangedParent()
Возвращает родителя компонента, возвращённого методом getChanged().
long getChangeFlags()
Возвращает битовую маску, указывающую типы событий HIERARCHY_CHANGED, представленных в этом объекте события.
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()
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

HIERARCHY_FIRST

public static final int HIERARCHY_FIRST
Обозначает первый целочисленный идентификатор диапазона идентификаторов событий иерархии.
См. также:
  • Значения константных полей

HIERARCHY_CHANGED

public static final int HIERARCHY_CHANGED
Идентификатор события, указывающий на изменение всего дерева иерархии.
См. также:
  • Значения константных полей

ANCESTOR_MOVED

public static final int ANCESTOR_MOVED
Идентификатор события, указывающий на перемещение предка-Container.
См. также:
  • Значения константных полей

ANCESTOR_RESIZED

public static final int ANCESTOR_RESIZED
Идентификатор события, указывающий на изменение размера предка-Container.
См. также:
  • Значения константных полей

HIERARCHY_LAST

public static final int HIERARCHY_LAST
Обозначает последний целочисленный идентификатор диапазона идентификаторов событий предков.
См. также:
  • Значения константных полей

PARENT_CHANGED

public static final int PARENT_CHANGED
Флаг изменения указывает, что событие HIERARCHY_CHANGED было сгенерировано операцией смены родителя.
См. также:
  • Значения константных полей

DISPLAYABILITY_CHANGED

public static final int DISPLAYABILITY_CHANGED
Флаг изменения указывает, что событие HIERARCHY_CHANGED было сгенерировано из-за изменения доступности иерархии для отображения. Чтобы определить текущую доступность иерархии для отображения, вызовите метод Component.isDisplayable. Изменения доступности для отображения происходят в ответ на явные или неявные вызовы методов Component.addNotify и Component.removeNotify.
См. также:
  • Component.isDisplayable()
  • Component.addNotify()
  • Component.removeNotify()
  • Значения константных полей

SHOWING_CHANGED

public static final int SHOWING_CHANGED
Флаг изменения указывает, что событие HIERARCHY_CHANGED было сгенерировано из-за изменения состояния отображения иерархии. Чтобы определить текущее состояние отображения иерархии, вызовите метод Component.isShowing. Состояние отображения меняется при изменении доступности иерархии для отображения или её видимости. Изменения видимости происходят в ответ на явные или неявные вызовы методов Component.show и Component.hide.
См. также:
  • Component.isShowing()
  • Component.addNotify()
  • Component.removeNotify()
  • Component.show()
  • Component.hide()
  • Значения константных полей

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

HierarchyEvent

public HierarchyEvent(Component source, int id, Component changed, Container changedParent)
Создаёт объект HierarchyEvent для обозначения изменения иерархии Component.

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

Параметры:
source — объект Component, который является источником события
id — целое число, указывающее тип события. Допустимые значения см. в описании класса HierarchyEvent
changed — Component в верхней части изменённой иерархии
changedParent — родительский объект компонента changed. В зависимости от типа изменения это может быть родительский объект до или после изменения
Исключения:
IllegalArgumentException — если source имеет значение null
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • getChanged()
  • getChangedParent()

HierarchyEvent

public HierarchyEvent(Component source, int id, Component changed, Container changedParent, long changeFlags)
Создаёт объект HierarchyEvent для обозначения изменения иерархии Component.

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

Параметры:
source — объект Component, который является источником события
id — целое число, указывающее тип события. Допустимые значения см. в описании класса HierarchyEvent
changed — Component в верхней части изменённой иерархии
changedParent — родительский объект компонента changed. В зависимости от типа изменения это может быть родительский объект до или после изменения
changeFlags — битовая маска, указывающая типы событий HIERARCHY_CHANGED, представленных в этом объекте события. Допустимые значения см. в описании класса HierarchyEvent
Исключения:
IllegalArgumentException — если source равно null
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • getChanged()
  • getChangedParent()
  • getChangeFlags()

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

getComponent

public Component getComponent()
Возвращает источник события.
Возвращает:
объект Component, который является источником события, или null, если объект не является Component.

getChanged

public Component getChanged()
Возвращает компонент в верхней части изменённой иерархии.
Возвращает:
изменённый компонент

getChangedParent

public Container getChangedParent()
Возвращает родителя компонента, возвращённого методом getChanged(). Для события HIERARCHY_CHANGED, в котором изменение имеет тип PARENT_CHANGED вследствие вызова Container.add, возвращаемый родитель — это родитель после операции добавления. Для события HIERARCHY_CHANGED, в котором изменение имеет тип PARENT_CHANGED вследствие вызова Container.remove, возвращаемый родитель — это родитель до операции удаления. Для всех остальных событий и типов возвращаемый родитель — это родитель во время операции.
Возвращает:
родителя изменённого компонента

getChangeFlags

public long getChangeFlags()
Возвращает битовую маску, указывающую типы событий HIERARCHY_CHANGED, представленных в этом объекте события. Биты объединены операцией побитового ИЛИ.
Возвращает:
битовую маску или 0, если это не событие HIERARCHY_CHANGED

paramString

public String paramString()
Возвращает строку параметров, описывающую это событие. Этот метод полезен для ведения журнала событий и отладки.
Переопределяет:
paramString в классе AWTEvent
Возвращает:
строку, описывающую событие и его атрибуты

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2026, 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.

Spec-Zone.ru

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