Spec-Zone.ru › OpenJDK 21

Иерархия событий 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), когда контейнер добавляется, удаляется, перемещается или изменяется в размерах, и передаётся по иерархии. Оно также генерируется объектом Component, когда вызывается метод addNotify, removeNotify, show, или hide. События ANCESTOR_MOVED и ANCESTOR_RESIZED рассылаются каждому объекту HierarchyBoundsListener или HierarchyBoundsAdapter, который зарегистрирован для получения таких событий, используя метод Component's addHierarchyBoundsListener. (Объекты HierarchyBoundsAdapter реализуют интерфейс HierarchyBoundsListener. События HIERARCHY_CHANGED рассылаются каждому объекту HierarchyListener, который зарегистрирован для получения таких событий, используя метод Component's 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, 2023, 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/21/docs/api/java.desktop/java/awt/event/HierarchyEvent.html

Spec-Zone.ru

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