モジュール java.desktop
パッケージ 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イベントは、そのコンポーネントの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
関連項目:

  • フィールド詳細

    • 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である場合
      関連項目:

    • 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である場合
      関連項目:

  • メソッドの詳細

    • 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
      戻り値:
      イベントを特定する文字列とその属性