モジュール java.desktop

パッケージ java.awt.event

クラス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のレイアウトや表示可能性は正しく動作します。

このイベントはPanelなどのContainerオブジェクトによって生成されます(Containerが追加、削除、移動、サイズ変更されて階層に渡されたとき)。 また、Componentオブジェクトによっても生成されます(そのオブジェクトのaddNotify、removeNotify、show、またはhideメソッドが呼び出されたとき)。 ANCESTOR_MOVEDおよびANCESTOR_RESIZEDイベントは、そのコンポーネントのaddHierarchyBoundsListenerメソッドを使ってこれらのイベントを受け取るように登録されている、すべてのHierarchyBoundsListenerまたはHierarchyBoundsAdapterオブジェクトにディスパッチされます。 (HierarchyBoundsAdapterオブジェクトは、HierarchyBoundsListenerインタフェースを実装します。) HIERARCHY_CHANGEDイベントは、ComponentのaddHierarchyListenerメソッドを使ってそれらのイベントを受け取るように登録されたすべてのHierarchyListenerオブジェクトにディスパッチされます。 それらの各リスナー・オブジェクトは、イベントが発生したときにHierarchyEventを取得します。

特定のHierarchyEventインスタンスのidパラメータがHIERARCHY_FIRSTからHIERARCHY_LASTまでの範囲にない場合に、未指定の動作が発生します。
HierarchyEventインスタンスのchangeFlagsパラメータは次のいずれかの値をとります。

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

上記以外の値を割り当てると、未指定の動作が発生します。

導入されたバージョン:

1.3

関連項目:

• HierarchyListener
• HierarchyBoundsAdapter
• HierarchyBoundsListener
• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final int	ANCESTOR_MOVED	祖先Containerが移動されたことを示すイベントIDです。
static final int	ANCESTOR_RESIZED	祖先Containerがサイズ変更されたことを示すイベントIDです。
static final int	DISPLAYABILITY_CHANGED	階層の表示可能性の変更により、HIERARCHY_CHANGEDイベントが生成されたことを示す変更フラグです。
static final int	HIERARCHY_CHANGED	階層ツリー全体が変更されたことを示すイベントIDです。
static final int	HIERARCHY_FIRST	階層イベントID範囲の最初の整数IDをマークします。
static final int	HIERARCHY_LAST	祖先イベントID範囲の最後の整数IDをマークします。
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)	Component階層の変更を識別するためのHierarchyEventオブジェクトを構築します。
HierarchyEvent(Component source, int id, Component changed, Container changedParent, long changeFlags)	Component階層の変更を識別するためのHierarchyEventオブジェクトを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
Component	getChanged()	変更された階層の最上位Componentを返します。
Container	getChangedParent()	getChanged()から返されたComponentの親を返します。
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

階層イベントID範囲の最初の整数IDをマークします。

関連項目:

• 定数フィールド値

HIERARCHY_CHANGED

public static final int HIERARCHY_CHANGED

階層ツリー全体が変更されたことを示すイベントIDです。

関連項目:

• 定数フィールド値

ANCESTOR_MOVED

public static final int ANCESTOR_MOVED

祖先Containerが移動されたことを示すイベントIDです。

関連項目:

• 定数フィールド値

ANCESTOR_RESIZED

public static final int ANCESTOR_RESIZED

祖先Containerがサイズ変更されたことを示すイベントIDです。

関連項目:

• 定数フィールド値

HIERARCHY_LAST

public static final int HIERARCHY_LAST

祖先イベントID範囲の最後の整数IDをマークします。

関連項目:

• 定数フィールド値

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)

Component階層の変更を識別するためのHierarchyEventオブジェクトを構築します。

このメソッドはsourceがnullの場合にIllegalArgumentExceptionをスローします。

パラメータ:

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)

Component階層の変更を識別するためのHierarchyEventオブジェクトを構築します。

このメソッドはsourceがnullの場合にIllegalArgumentExceptionをスローします。

パラメータ:

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オブジェクト。オブジェクトがComponentでない場合はnull。

getChanged

public Component getChanged()

変更された階層の最上位Componentを返します。

戻り値:

変更されたComponent

getChangedParent

public Container getChangedParent()

getChanged()から返されたComponentの親を返します。 HIERARCHY_CHANGEDイベントで、変更がContainer.add呼出しによるPARENT_CHANGEDタイプの場合は、返される親は追加オペレーション後の親です。 HIERARCHY_CHANGEDイベントで、変更がContainer.remove呼出しによるPARENT_CHANGEDタイプの場合、返される親は削除オペレーション前の親です。 ほかのすべてのイベントやタイプの場合は、返される親はオペレーション時の親です。

戻り値:

変更されたComponentの親

getChangeFlags

public long getChangeFlags()

このイベント・オブジェクトで表現されたHIERARCHY_CHANGEDイベントのタイプを示すビット・マスクを返します。 ビットは、ビット単位で論理和されています。

戻り値:

ビット・マスク、これがHIERARCHY_CHANGEDイベントでない場合は0

paramString

public String paramString()

このイベントを特定するパラメータ文字列を返します。 このメソッドは、イベント・ログの作成およびデバッグに便利です。

オーバーライド:

paramString、クラスAWTEvent

戻り値:

イベントを特定する文字列とその属性