Класс иерархииEvent

public class HierarchyEvent
extends AWTEvent

Событие, которое указывает на изменение иерархии, к которой относится Component.

• События изменения иерархии (HierarchyListener)
  • добавление предка
  • удаление предка
  • иерархия стала отображаемой
  • иерархия стала неотображаемой
  • иерархия отображается на экране (как видимая, так и отображаемая)
  • иерархия скрыта на экране (либо невидимая, либо неотображаемая)
• События изменения формы предка (HierarchyBoundsListener)
  • предок был изменён по размеру
  • предок был перемещён

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

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

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

• HierarchyEvent.PARENT_CHANGED
• HierarchyEvent.DISPLAYABILITY_CHANGED
• HierarchyEvent.SHOWING_CHANGED

Присвоение значения, отличного от указанных выше, вызовет неопределённое поведение.

Поля

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)

Параметры:

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)

Параметры:

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

Возвращает:

строка, идентифицирующая событие и его атрибуты