Spec-Zone.ru › OpenJDK 24

Иерархия событий 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 автоматически обрабатывает изменения в иерархии внутри, чтобы правильно работала компоновка и отображение GUI независимо от того, получает ли программа эти события или нет.

Это событие генерируется объектом 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 было сгенерировано из-за изменения состояния отображения иерархии.

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

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

Конструктор Описание
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()
Возвращает строку-параметр, идентифицирующую это событие.

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

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

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

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/event/HierarchyEvent.html

Spec-Zone.ru

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