java.awt.event
クラス HierarchyEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--java.awt.AWTEvent
              |
              +--java.awt.event.HierarchyEvent

すべての実装インタフェース:

Serializable

public class HierarchyEvent

extends AWTEvent

コンポーネントが所属する 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 変更された階層の表示可能性を表します。
static int	HIERARCHY_CHANGED 階層ツリー全体が変更されました。
static int	HIERARCHY_FIRST 階層イベント識別子の範囲を示す最初の番号です。
static int	HIERARCHY_LAST 上位クラスのイベント識別子を表す整数の範囲の、最後の番号です。
static int	PARENT_CHANGED 親設定オペレーションで変更された階層
static int	SHOWING_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, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_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() 変更された階層の最上位のコンポーネントを返します。
Container	getChangedParent() getChanged() が返したコンポーネントの親を返します。
long	getChangeFlags() このイベントオブジェクトで表現された HIERARCHY_CHANGED イベントのタイプを示すビットマスクを返します。
Component	getComponent() イベントの発生元を返します。
String	paramString() このイベントを特定するパラメータの文字列を返します。

クラス java.awt.AWTEvent から継承したメソッド

consume, finalize, getID, isConsumed, toString

クラス java.util.EventObject から継承したメソッド

getSource

クラス java.lang.Object から継承したメソッド

clone, equals, 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

親設定オペレーションで変更された階層

DISPLAYABILITY_CHANGED

public static final int DISPLAYABILITY_CHANGED

変更された階層の表示可能性を表します。現在の階層の表示可能性を判断するには、Component.isDisplayable() を呼び出します。表示可能性の変更は、Component.addNotify() と Component.removeNotify() の明示的または暗黙的な呼び出しに対して発生します。

関連項目:

Component.isDisplayable(), Component.addNotify(), Component.removeNotify()

SHOWING_CHANGED

public static final int SHOWING_CHANGED

変更されたイベントの表示状態を示します。現在の階層の表示状態を判断するには、Component.isShowing() を呼び出します。階層の表示可能性または可視性のどちらかが発生すると、表示状態が変更されます。表示可能性は、Component.addNotify() と Component.removeNotify() の明示的または暗黙的な呼び出しにより変更されます。可視性の変更は、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 - イベントの発生元の Component オブジェクト

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

changed - 変更された階層の最上位のコンポーネント

changedParent - changed の親。変更のタイプによって、変更前または変更後の親になる

HierarchyEvent

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

Component 階層に変更を識別する HierarchyEvent オブジェクトを生成します。

パラメータ:

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

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

changed - 変更された階層の最上位のコンポーネント

changedParent - changed の親。変更のタイプによって、変更前または変更後の親になる

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

メソッドの詳細

getComponent

public Component getComponent()

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

戻り値:

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

getChanged

public Component getChanged()

変更された階層の最上位のコンポーネントを返します。

戻り値:

変更されたコンポーネント

getChangedParent

public Container getChangedParent()

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

戻り値:

変更されたコンポーネントの親

getChangeFlags

public long getChangeFlags()

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

戻り値:

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

paramString

public String paramString()

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

オーバーライド:

クラス AWTEvent 内の paramString

戻り値:

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