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 階層の変更を示すイベントです。

• Hierarchy Change Events (HierarchyListener)
  • 上位クラスの追加
  • 上位クラスの削除
  • 表示可能な階層
  • 表示不可能な階層
  • 可視および表示可能な画面に表示される階層
  • 不可視または表示不可能な画面上に表示されない階層
• Ancestor Reshape Events (HierarchyBoundsListener)
  • サイズ変更された上位クラス
  • 移動された上位クラス

階層イベントは通知の目的にだけ提供されます。AWT は階層の変更を内部的に自動で取り扱うので、プログラムが階層イベントを受け取るかどうかに関係なく、GUI のレイアウトや表示可能性は正しく動作します。

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

導入されたバージョン:

1.3

関連項目:

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

フィールドの概要

static int	ANCESTOR_MOVED 上位コンテナが移動されたことを示すイベント識別子です。
static int	ANCESTOR_RESIZED 上位コンテナがサイズ変更されたことを示すイベント識別子です。
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 イベントが生成されたことを示します。

クラス 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)
HierarchyEvent オブジェクトを構築して、Component 階層の変更を識別します。

HierarchyEvent(Component source, int id, Component changed, Container changedParent, long changeFlags)
HierarchyEvent オブジェクトを構築して、Component 階層の変更を識別します。

メソッドの概要

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

階層イベント識別子の範囲を示す最初の番号です。

関連項目:

定数フィールド値

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)

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

無効な id を渡して、特定できない動作を発生させないようにしてください。このメソッドは source が null の場合に IllegalArgumentException をスローします。

パラメータ:

source - イベントの発生元の Component オブジェクト

id - イベントの型を示す整数

changed - 変更された階層の最上位 Component

changedParent - changed の親。変更の種類に応じて、変更前または変更後の親になる

例外:

IllegalArgumentException - source が null の場合

HierarchyEvent

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

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

無効な id を渡して、特定できない動作を発生させないようにしてください。このメソッドは source が null の場合に IllegalArgumentException をスローします。

パラメータ:

source - イベントの発生元の Component オブジェクト

id - イベントの型を示す整数

changed - 変更された階層の最上位 Component

changedParent - changed の親。変更の種類に応じて、変更前または変更後の親になる

changeFlags - このイベントオブジェクトで表現された HIERARCHY_CHANGED イベントの型を示すビットマスク

例外:

IllegalArgumentException - source が null の場合

メソッドの詳細

getComponent

public Component getComponent()

イベントの発生元を返します。

戻り値:

イベントの発生元の Component オブジェクト。オブジェクトが Component でない場合は null

getChanged

public Component getChanged()

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

戻り値:

変更された Component

getChangedParent

public Container getChangedParent()

getChanged() が返した Component の親を返します。変更が Container.add の呼び出しを使う PARENT_CHANGED 型の HIERARCHY_CHANGED イベントの場合、追加オペレーション後の親が返されます。変更が Container.remove の呼び出しを使う PARENT_CHANGED 型の HIERARCHY_CHANGED イベントの場合、削除オペレーションの前の親が返されます。その他のすべてのイベントや型では、オペレーション時の親が返されます。

戻り値:

変更された Component の親

getChangeFlags

public long getChangeFlags()

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

戻り値:

ビットマスク。HIERARCHY_CHANGED イベントでない場合は 0

paramString

public String paramString()

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

オーバーライド:

クラス AWTEvent 内の paramString

戻り値:

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