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, 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.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

戻り値:

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