クラス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
関連項目:

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final int
    ANCESTOR_MOVED
    祖先Containerが移動されたことを示すイベントIDです。
    static final int
    ANCESTOR_RESIZED
    祖先Containerがサイズ変更されたことを示すイベントIDです。
    static final int
    DISPLAYABILITY_CHANGED
    階層の表示可能性の変更により、HIERARCHY_CHANGEDイベントが生成されたことを示す変更フラグです。
    static final int
    HIERARCHY_CHANGED
    階層ツリー全体が変更されたことを示すイベントIDです。
    static final int
    HIERARCHY_FIRST
    階層イベントID範囲の最初の整数IDをマークします。
    static final int
    HIERARCHY_LAST
    祖先イベントID範囲の最後の整数IDをマークします。
    static final int
    PARENT_CHANGED
    HIERARCHY_CHANGEDイベントが親変更オペレーションにより生成されたことを示す変更フラグです。
    static final int
    SHOWING_CHANGED
    階層表示状態の変更によりHIERARCHY_CHANGEDイベントが生成されたことを示す変更フラグです。

    クラスで宣言されたフィールド 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
    修飾子と型
    フィールド
    説明
    static final long
    ACTION_EVENT_MASK
    アクション・イベント選択用イベント・マスクです。
    static final long
    ADJUSTMENT_EVENT_MASK
    調整イベント選択用イベント・マスクです。
    static final long
    COMPONENT_EVENT_MASK
    コンポーネント・イベント選択用イベント・マスクです。
    protected boolean
    consumed
    転送元の処理後にイベントをピアに送り返すかどうかを制御します。trueの場合は送り返されず、falseの場合は送り返されます。
    static final long
    CONTAINER_EVENT_MASK
    コンテナ・イベント選択用イベント・マスクです。
    static final long
    FOCUS_EVENT_MASK
    フォーカス・イベント選択用イベント・マスクです。
    static final long
    HIERARCHY_BOUNDS_EVENT_MASK
    階層境界イベント選択用イベント・マスクです。
    static final long
    HIERARCHY_EVENT_MASK
    階層イベント選択用イベント・マスクです。
    protected int
    id
    イベントのID
    static final long
    INPUT_METHOD_EVENT_MASK
    インプット・メソッド・イベント選択用イベント・マスクです。
    static final long
    INVOCATION_EVENT_MASK
    呼出しイベント選択用イベント・マスクです。
    static final long
    ITEM_EVENT_MASK
    項目イベント選択用イベント・マスクです。
    static final long
    KEY_EVENT_MASK
    キー・イベント選択用イベント・マスクです。
    static final long
    MOUSE_EVENT_MASK
    マウス・イベント選択用イベント・マスクです。
    static final long
    MOUSE_MOTION_EVENT_MASK
    マウス・モーション・イベント選択用イベント・マスクです。
    static final long
    MOUSE_WHEEL_EVENT_MASK
    マウス・ホイール・イベント選択用イベント・マスクです。
    static final long
    PAINT_EVENT_MASK
    ペイント・イベント選択用イベント・マスクです。
    static final int
    RESERVED_ID_MAX
    予約済みAWTイベントIDの最大値です。
    static final long
    TEXT_EVENT_MASK
    テキスト・イベント選択用イベント・マスクです。
    static final long
    WINDOW_EVENT_MASK
    ウィンドウ・イベント選択用イベント・マスクです。
    static final long
    WINDOW_FOCUS_EVENT_MASK
    ウィンドウ・フォーカス・イベント選択用イベント・マスクです。
    static final long
    WINDOW_STATE_EVENT_MASK
    ウィンドウ状態イベント選択用イベント・マスクです。

    クラスで宣言されたフィールド EventObject

    source
    修飾子と型
    フィールド
    説明
    protected Object
    source
    Eventが最初に発生したオブジェクト。

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    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()
    このイベントを特定するパラメータ文字列を返します。

    クラスで宣言されたメソッド AWTEvent

    consume, getID, isConsumed, setSource, toString
    修飾子と型
    メソッド
    説明
    protected void
    consume()
    このイベントを消費できる場合は消費します。
    int
    getID()
    イベント・タイプを返します。
    protected boolean
    isConsumed()
    このイベントが消費されたかどうかを返します。
    void
    setSource(Object newSource)
    イベントを新しいソースにターゲット変更します。
    String
    toString()
    このオブジェクトの文字列表現を返します。

    クラスで宣言されたメソッド EventObject

    getSource
    修飾子と型
    メソッド
    説明
    Object
    getSource()
    Eventが最初に発生したオブジェクト。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

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