- java.lang.Object
-
- java.util.EventObject
-
- java.awt.AWTEvent
-
- java.awt.event.ComponentEvent
-
- java.awt.event.ContainerEvent
-
- すべての実装されたインタフェース:
Serializable
public class ContainerEvent extends ComponentEvent
コンポーネントが追加または削除されたためにコンテナの内容が変更されたことを示す、低レベル・イベントです。コンテナ・イベントは、通知のためだけに提供されています。AWTは、コンテナ内容への変更を内部的に自動的に扱うので、プログラムがこれらのイベントを受け取るかどうかに関係なく、プログラムは正しく動作します。
この低レベル・イベントは、コンテナにコンポーネントが追加されたときまたはコンテナからコンポーネントが削除されたときに、コンテナ・オブジェクト(Panelなど)によって生成されます。 イベントは、そのコンポーネントの
addContainerListener
メソッドを使ってこれらのイベントを受け取るように登録されている、すべてのContainerListener
またはContainerAdapter
オブジェクトに渡されます。 (ContainerAdapter
オブジェクトはContainerListener
インタフェースを実装します。) 各リスナー・オブジェクトは、イベントが発生したときにこのContainerEvent
を取得します。特定の
ContainerEvent
インスタンスのid
パラメータがCONTAINER_FIRST
からCONTAINER_LAST
までの範囲にない場合に、未指定の動作が発生します。- 導入されたバージョン:
- 1.1
- 関連項目:
ContainerAdapter
,ContainerListener
, Tutorial: Writing a Container Listener, 直列化された形式
-
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static int
COMPONENT_ADDED
このイベントは、コンテナにコンポーネントが追加されたことを示します。static int
COMPONENT_REMOVED
このイベントは、コンテナからコンポーネントが削除されたことを示します。static int
CONTAINER_FIRST
コンテナ・イベントに使用されるIDの範囲内の最初の番号です。static int
CONTAINER_LAST
コンテナ・イベントに使用されるIDの範囲内の最後の番号です。-
クラス 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.awt.event.ComponentEventで宣言されたフィールド
COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN
-
クラス java.util.EventObjectで宣言されたフィールド
source
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 ContainerEvent(Component source, int id, Component child)
ContainerEvent
オブジェクトを構築します。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 Component
getChild()
イベントによって影響を受けたコンポーネントを返します。Container
getContainer()
イベントの発生元を返します。String
paramString()
このイベントを特定するパラメータ文字列を返します。-
クラス java.awt.event.ComponentEventで宣言されたメソッド
getComponent
-
クラス java.util.EventObjectで宣言されたメソッド
getSource
-
-
-
-
フィールドの詳細
-
CONTAINER_FIRST
public static final int CONTAINER_FIRST
コンテナ・イベントに使用されるIDの範囲内の最初の番号です。- 関連項目:
- 定数フィールド値
-
CONTAINER_LAST
public static final int CONTAINER_LAST
コンテナ・イベントに使用されるIDの範囲内の最後の番号です。- 関連項目:
- 定数フィールド値
-
COMPONENT_ADDED
public static final int COMPONENT_ADDED
このイベントは、コンテナにコンポーネントが追加されたことを示します。- 関連項目:
- 定数フィールド値
-
COMPONENT_REMOVED
public static final int COMPONENT_REMOVED
このイベントは、コンテナからコンポーネントが削除されたことを示します。- 関連項目:
- 定数フィールド値
-
-
コンストラクタの詳細
-
ContainerEvent
public ContainerEvent(Component source, int id, Component child)
ContainerEvent
オブジェクトを構築します。このメソッドは
source
がnull
の場合にIllegalArgumentException
をスローします。- パラメータ:
source
- イベントを発生させたComponent
オブジェクト(コンテナ)id
- イベントのタイプを示す整数。 許容される値については、ContainerEvent
のクラスの説明を参照してください。child
- 追加または削除されたコンポーネント- 例外:
IllegalArgumentException
-source
がnullである場合- 関連項目:
getContainer()
,AWTEvent.getID()
,getChild()
-
-
メソッドの詳細
-
getContainer
public Container getContainer()
イベントの発生元を返します。- 戻り値:
- イベントを発生させた
Container
オブジェクト。オブジェクトがContainer
でない場合はnull
。
-
getChild
public Component getChild()
イベントによって影響を受けたコンポーネントを返します。- 戻り値:
- 追加または削除されたComponentオブジェクト
-
paramString
public String paramString()
このイベントを特定するパラメータ文字列を返します。 このメソッドは、イベント・ログの作成およびデバッグに便利です。- オーバーライド:
paramString
、クラス:ComponentEvent
- 戻り値:
- イベントを特定する文字列とその属性
-
-