java.awt.event

Class HierarchyEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.HierarchyEvent

All Implemented Interfaces:

Serializable

public class HierarchyEvent
extends AWTEvent

这一事件表明，改变了 Component层次， Component属。

• 层次变化事件（hierarchylistener）
  • 增加一个祖先
  • 去除祖先
  • 层次进行显示
  • 使不可显示的层次结构
  • 层次结构显示在屏幕上（是可见的和可显示）
  • 层次隐藏在屏幕（或不可见或不可显示）
• 祖先重塑事件（hierarchyboundslistener）
  • 一个祖先是调整
  • 一个祖先被感动了

仅为通知目的提供层次结构事件。AWT将自动处理变化的层次内部，界面布局和显示工作正常，不管程序是否接收这些事件或不。

此事件是由一个容器对象生成的（如面板）当容器添加，删除，移动或调整大小，并流传下来的层次。它也是由一个组件对象时产生的对象的addNotify，removeNotify，show，或hide方法称为。的ANCESTOR_MOVED和ANCESTOR_RESIZED事件被派遣到每一HierarchyBoundsListener或HierarchyBoundsAdapter对象注册到使用组件的addHierarchyBoundsListener方法接收这样的事件。（HierarchyBoundsAdapter对象实现了 HierarchyBoundsListener接口。）的HIERARCHY_CHANGED事件被分派到每个HierarchyListener对象注册到使用组件的addHierarchyListener 方法接收这样的事件。每一个这样的听众对象得到这个HierarchyEvent 事件发生时。

未指定的行为将如果任何特定的HierarchyEvent实例的id参数不在HIERARCHY_FIRST到HIERARCHY_LAST范围造成的。
任何HierarchyEvent实例的changeFlags参数取下列值之一：

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

分配值的不同将导致从上面列出的未指定的行为。

从以下版本开始：

一点三

另请参见：

HierarchyListener， HierarchyBoundsAdapter， HierarchyBoundsListener， Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	ANCESTOR_MOVED 指示一个祖先容器被移动的事件标识。
static int	ANCESTOR_RESIZED 指示一个祖先容器事件ID被缩放。
static int	DISPLAYABILITY_CHANGED 一个改变标志表明 HIERARCHY_CHANGED事件是由于该层次结构的变化产生的显示。
static int	HIERARCHY_CHANGED 事件标识表明对整个层次结构树进行了修改。
static int	HIERARCHY_FIRST 标记层次结构事件标识的范围的第一个整数标识。
static int	HIERARCHY_LAST 标记祖先事件标识的范围的最后一个整数标识。
static int	PARENT_CHANGED 改变标志表示该事件是由一个 HIERARCHY_CHANGED抚育操作产生。
static int	SHOWING_CHANGED 一个改变标志表明 HIERARCHY_CHANGED事件是由于该层次显示状态变化产生的。

Fields inherited from 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

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
HierarchyEvent(Component source, int id, Component changed, Container changedParent) 构建了一个 HierarchyEvent对象确定在 Component层次变化。
HierarchyEvent(Component source, int id, Component changed, Container changedParent, long changeFlags) 构建以确定在 Component层次变化 HierarchyEvent对象。

方法摘要

Modifier and Type	Method and Description
Component	getChanged() 返回更改了层次结构顶部的组件。
Container	getChangedParent() 返回父组件的 getChanged()返回的。
long	getChangeFlags() 返回的位掩码，指示型（S）的事件，这个事件对象表示hierarchy_changed。
Component	getComponent() 返回事件的发起人。
String	paramString() 返回标识此事件的参数字符串。

Methods inherited from class java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

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

Field Detail

HIERARCHY_FIRST

public static final int HIERARCHY_FIRST

标记层次结构事件标识的范围的第一个整数标识。

另请参见：

Constant Field Values

HIERARCHY_CHANGED

public static final int HIERARCHY_CHANGED

事件标识表明对整个层次结构树进行了修改。

另请参见：

Constant Field Values

ANCESTOR_MOVED

public static final int ANCESTOR_MOVED

指示一个祖先容器被移动的事件标识。

另请参见：

Constant Field Values

ANCESTOR_RESIZED

public static final int ANCESTOR_RESIZED

指示一个祖先容器事件ID被缩放。

另请参见：

Constant Field Values

HIERARCHY_LAST

public static final int HIERARCHY_LAST

标记祖先事件标识的范围的最后一个整数标识。

另请参见：

Constant Field Values

PARENT_CHANGED

public static final int PARENT_CHANGED

改变标志表示该事件是由一个 HIERARCHY_CHANGED抚育操作产生。

另请参见：

Constant Field Values

DISPLAYABILITY_CHANGED

public static final int DISPLAYABILITY_CHANGED

一个改变标志表明 HIERARCHY_CHANGED事件是由于该层次结构的变化产生的显示。区分层次的电流显示，叫 Component.isDisplayable方法。显示的变化发生在响应于显式或隐式的 Component.addNotify和 Component.removeNotify方法调用。

另请参见：

Component.isDisplayable()， Component.addNotify()， Component.removeNotify()， Constant Field Values

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()， Constant Field Values

Constructor Detail

HierarchyEvent

public HierarchyEvent(Component source,
                      int id,
                      Component changed,
                      Container changedParent)

构建以确定在 Component层次变化 HierarchyEvent对象。

该方法抛出一个IllegalArgumentException如果source是null。

参数

source - Component对象产生的事件

id -整数表示事件的类型。在允许值的信息，看到 HierarchyEvent类的描述

changed -在层次上改变了 Component

changedParent的 changed组件的父。这可能是父母在改变之前或之后，取决于类型的变化

异常

如果是 null source IllegalArgumentException

另请参见：

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 -一位掩码说明型（S）在这个事件对象表示的 HIERARCHY_CHANGED事件。在允许值的信息，看到 HierarchyEvent类的描述

异常

IllegalArgumentException -如果 source是空的

另请参见：

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()

返回的位掩码，指示型（S）的事件，这个事件对象表示hierarchy_changed。位已经按位或。

结果

的位掩码，或0如果这不是一个hierarchy_changed事件

paramString

public String paramString()

返回标识此事件的参数字符串。此方法用于事件日志记录和调试是有用的。

重写：

paramString 方法重写，继承类 AWTEvent

结果

识别事件及其属性的字符串