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 イベントは、Component の 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 int	ANCESTOR_MOVED 祖先 Container が移動されたことを示すイベント ID です。
static int	ANCESTOR_RESIZED 祖先 Container がサイズ変更されたことを示すイベント ID です。
static int	DISPLAYABILITY_CHANGED 階層の表示可能性の変更により、HIERARCHY_CHANGED イベントが生成されたことを示す変更フラグです。
static int	HIERARCHY_CHANGED 階層ツリー全体が変更されたことを示すイベント ID です。
static int	HIERARCHY_FIRST 階層イベント ID 範囲の最初の整数 ID をマークします。
static int	HIERARCHY_LAST 祖先イベント ID 範囲の最後の整数 ID をマークします。
static int	PARENT_CHANGED HIERARCHY_CHANGED イベントが親変更オペレーションにより生成されたことを示す変更フラグです。
static 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

戻り値:

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