モジュール java.desktop
パッケージ 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, 直列化された形式

    • フィールドの詳細

      • 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メソッドの明示的または暗黙的呼出しに応答して発生します。
        関連項目:
        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)
        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
        戻り値:
        イベントを特定する文字列とその属性