モジュール java.desktop

パッケージ java.awt.event

クラスContainerEvent

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
• チュートリアル: コンテナ・リスナーの記述
• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final int	COMPONENT_ADDED	このイベントは、コンテナにコンポーネントが追加されたことを示します。
static final int	COMPONENT_REMOVED	このイベントは、コンテナからコンポーネントが削除されたことを示します。
static final int	CONTAINER_FIRST	コンテナ・イベントに使用されるIDの範囲内の最初の番号です。
static final int	CONTAINER_LAST	コンテナ・イベントに使用されるIDの範囲内の最後の番号です。

クラスjava.awt.event.ComponentEventで宣言されたフィールド

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

クラス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

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

コンストラクタ

コンストラクタ	説明
ContainerEvent(Component source, int id, Component child)	ContainerEventオブジェクトを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
Component	getChild()	イベントによって影響を受けたコンポーネントを返します。
Container	getContainer()	イベントの発生元を返します。
String	paramString()	このイベントを特定するパラメータ文字列を返します。

クラスjava.awt.event.ComponentEventで宣言されたメソッド

getComponent

クラス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

フィールド詳細

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

戻り値:

イベントを特定する文字列とその属性