- 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 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.util.EventObjectで宣言されたメソッド
getSource
-
-
-
-
フィールドの詳細
-
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
メソッドの明示的または暗黙的呼出しに応答して発生します。
-
SHOWING_CHANGED
public static final int SHOWING_CHANGED
階層表示状態の変更によりHIERARCHY_CHANGED
イベントが生成されたことを示す変更フラグです。 階層の現在の表示状態を判断するには、Component.isShowing
メソッドを呼び出します。 階層の表示可能性または可視性のどちらかが発生すると、表示状態の変更が発生します。 可視性の変更は、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
- 戻り値:
- イベントを特定する文字列とその属性
-
-