java.awt.event

Класс HierarchyEvent

java.lang. Объект

java.util. EventObject

java.awt. AWTEvent

java.awt.event. HierarchyEvent

Все Реализованные Интерфейсы:

Сериализуемый

public class HierarchyEvent
extends AWTEvent

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

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

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

Это событие сгенерировано Контейнерным объектом (таким как Панель), когда Контейнер добавляется, удаляется, перемещается, или изменяется, и передал иерархию. Это также сгенерировано Компонентным объектом когда тот объект 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 int	ANCESTOR_MOVED Идентификатор события, указывающий на контейнер предка, был перемещен.
static int	ANCESTOR_RESIZED Идентификатор события, указывающий на контейнер предка, был изменен.
static int	DISPLAYABILITY_CHANGED Флаг изменения указывает что HIERARCHY_CHANGED событие было сгенерировано из-за изменения иерархии displayability.
static int	HIERARCHY_CHANGED Идентификатор события, указывающий, что модификация была сделана ко всему дереву иерархии.
static int	HIERARCHY_FIRST Отмечает первый целочисленный идентификатор для диапазона идентификаторов события иерархии.
static int	HIERARCHY_LAST Отмечает последний целочисленный идентификатор для диапазона идентификаторов события предка.
static int	PARENT_CHANGED Флаг изменения указывает что HIERARCHY_CHANGED событие было сгенерировано работой перепорождения.
static int	SHOWING_CHANGED Флаг изменения указывает что HIERARCHY_CHANGED событие было сгенерировано из-за изменения состояния показа иерархии.

Поля, наследованные от class 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

Поля, наследованные от class java.util. EventObject

источник

Сводка конструктора

Конструкторы

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

Сводка метода

Модификатор и Тип	Метод и Описание
Компонент	getChanged() Возвращает Компонент наверху иерархии, которая была изменена.
Контейнер	getChangedParent() Возвращает родителя Компонента, возвращенного getChanged().
long	getChangeFlags() Возвращает битовую маску, которая указывает на тип (ы) событий HIERARCHY_CHANGED, представленных в этом объекте-событии.
Компонент	getComponent() Возвращает инициатора события.
Строка	paramString() Возвращает строку параметра, идентифицирующую это событие.

Методы, наследованные от class java.awt. AWTEvent

consume, getID, isConsumed, setSource, toString

Методы, наследованные от class java.util. EventObject

getSource

Методы, наследованные от class java.lang. Объект

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 событие было сгенерировано из-за изменения иерархии displayability. Чтобы различить ток displayability иерархии, вызовите Component.isDisplayable метод. Изменения Displayability происходят в ответ на явные или неявные вызовы Component.addNotify и Component.removeNotify методы.

См. Также:

Component.isDisplayable(), Component.addNotify(), Component.removeNotify(), Постоянные Значения полей

SHOWING_CHANGED

public static final int SHOWING_CHANGED

Флаг изменения указывает что HIERARCHY_CHANGED событие было сгенерировано из-за изменения состояния показа иерархии. Чтобы различить текущее состояние показа иерархии, вызовите Component.isShowing метод. Изменения состояния показа происходят, когда или displayability или видимость иерархии происходят. Изменения видимости происходят в ответ на явные или неявные вызовы 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 - Целое число, указывающее на тип события. Для получения информации о допустимых значениях см. описание class для 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 - Целое число, указывающее на тип события. Для получения информации о допустимых значениях см. описание class для HierarchyEvent

changed - Component наверху иерархии, которая была изменена

changedParent - Родитель changed компонент. Это может быть родителем прежде или после изменения, в зависимости от типа изменения

changeFlags - Битовая маска, которая указывает на тип (ы) HIERARCHY_CHANGED события представляются в этом объекте-событии. Для получения информации о допустимых значениях см. описание class для HierarchyEvent

Броски:

IllegalArgumentException - если source нуль

См. Также:

EventObject.getSource(), AWTEvent.getID(), getChanged(), getChangedParent(), getChangeFlags()

Деталь метода

getComponent

public Component getComponent()

Возвращает инициатора события.

Возвраты:

Component возразите, что породил событие, или null если объект не является a 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, представленных в этом объекте-событии. Биты были поразрядными-ored вместе.

Возвраты:

битовая маска, или 0, если это не событие HIERARCHY_CHANGED

paramString

public String paramString()

Возвращает строку параметра, идентифицирующую это событие. Этот метод полезен для регистрации событий и для отладки.

Переопределения:

paramString в class AWTEvent

Возвраты:

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