JavaTM 2 Platform
Std. Ed. v1.3

java.awt.event
クラス HierarchyEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--java.awt.AWTEvent
              |
              +--java.awt.event.HierarchyEvent
すべての実装インタフェース:
Serializable

public class HierarchyEvent
extends AWTEvent

コンポーネントが所属する Component 階層の変更を示すイベントです。

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

このイベントは、コンテナが追加、削除、移動、サイズ変更が行われ、該当階層に渡されたときに、Panel などの Container オブジェクトによって生成されます。また、オブジェクトの addNotifyremoveNotifyshow、または 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
戻り値:
イベントを特定する文字列とその属性

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.