JavaTM Platform
Standard Ed. 6

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 階層の変更を示すイベントです。

階層イベントは通知の目的にだけ提供されます。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
          階層の表示可能性の変更により、HIERARCHY_CHANGED イベントが生成されたことを示します。
static int HIERARCHY_CHANGED
          階層ツリー全体が変更されたことを示すイベント識別子です。
static int HIERARCHY_FIRST
          階層イベント識別子の範囲を示す最初の番号です。
static int HIERARCHY_LAST
          上位クラスのイベント識別子を表す整数の範囲の、最後の番号です。
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)
          HierarchyEvent オブジェクトを構築して、Component 階層の変更を識別します。
HierarchyEvent(Component source, int id, Component changed, Container changedParent, long changeFlags)
          HierarchyEvent オブジェクトを構築して、Component 階層の変更を識別します。
 
メソッドの概要
 Component getChanged()
          変更された階層の最上位 Component を返します。
 Container getChangedParent()
          getChanged() が返した Component の親を返します。
 long getChangeFlags()
          このイベントオブジェクトで表現された HIERARCHY_CHANGED イベントの型を示すビットマスクを返します。
 Component getComponent()
          イベントの発生元を返します。
 String paramString()
          このイベントを特定するパラメータの文字列を返します。
 
クラス java.awt.AWTEvent から継承されたメソッド
consume, getID, isConsumed, setSource, toString
 
クラス java.util.EventObject から継承されたメソッド
getSource
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, 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
HIERARCHY_CHANGED イベントが、親設定オペレーションにより生成されたことを示します。

関連項目:
定数フィールド値

DISPLAYABILITY_CHANGED

public static final int DISPLAYABILITY_CHANGED
階層の表示可能性の変更により、HIERARCHY_CHANGED イベントが生成されたことを示します。現在の階層の表示可能性を判断するには、Component.isDisplayable を呼び出します。表示可能性は Component.addNotifyComponent.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)
HierarchyEvent オブジェクトを構築して、Component 階層の変更を識別します。  

無効な id を渡して、特定できない動作を発生させないようにしてください。このメソッドは sourcenull の場合に IllegalArgumentException をスローします。

パラメータ:
source - イベントの発生元の Component オブジェクト
id - イベントの型を示す整数
changed - 変更された階層の 最上位 Component
changedParent - changed の親。 変更の種類に応じて、 変更前または変更後の親になる
例外:
IllegalArgumentException - source が null の場合

HierarchyEvent

public HierarchyEvent(Component source,
                      int id,
                      Component changed,
                      Container changedParent,
                      long changeFlags)
HierarchyEvent オブジェクトを構築して、Component 階層の変更を識別します。  

無効な id を渡して、特定できない動作を発生させないようにしてください。このメソッドは sourcenull の場合に IllegalArgumentException をスローします。

パラメータ:
source - イベントの発生元の Component オブジェクト
id - イベントの型を示す整数
changed - 変更された階層の 最上位 Component
changedParent - changed の親。 変更の種類に応じて、 変更前または変更後の親になる
changeFlags - このイベントオブジェクトで表現された HIERARCHY_CHANGED イベントの 型を示すビットマスク
例外:
IllegalArgumentException - source が null の場合
メソッドの詳細

getComponent

public Component getComponent()
イベントの発生元を返します。

戻り値:
イベントの発生元の Component オブジェクト。 オブジェクトが Container でない場合は null

getChanged

public Component getChanged()
変更された階層の最上位 Component を返します。

戻り値:
変更された Component

getChangedParent

public Container getChangedParent()
getChanged() が返した Component の親を返します。変更が Container.add の呼び出しを使う PARENT_CHANGED 型の HIERARCHY_CHANGED イベントの場合、追加オペレーション後の親が返されます。変更が Container.remove の呼び出しを使う PARENT_CHANGED 型の HIERARCHY_CHANGED イベントの場合、削除オペレーションの前の親が返されます。その他のすべてのイベントや型では、オペレーション時の親が返されます。

戻り値:
変更された Component の親

getChangeFlags

public long getChangeFlags()
このイベントオブジェクトで表現された HIERARCHY_CHANGED イベントの型を示すビットマスクを返します。ビットは、ビット単位の論理和です。

戻り値:
ビットマスク。HIERARCHY_CHANGED イベントでない場合は 0

paramString

public String paramString()
このイベントを特定するパラメータの文字列を返します。このメソッドは、イベントログの作成およびデバッグに使用します。

オーバーライド:
クラス AWTEvent 内の paramString
戻り値:
イベントを特定する文字列とその属性

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。