Spec-Zone.ru › OpenJDK 25

Класс 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
Идентификатор события, указывающий на перемещение предка-контейнера.
static final int ANCESTOR_RESIZED
Идентификатор события, указывающий на изменение размера предка-контейнера.
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

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

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

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

getSource

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

HIERARCHY_FIRST

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

HIERARCHY_CHANGED

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

ANCESTOR_MOVED

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

ANCESTOR_RESIZED

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

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, 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/HierarchyEvent.html

Spec-Zone.ru

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