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 などのコンテナオブジェクトによって生成されます。発生したイベントは、コンポーネントの addContainerListner メソッドを使って、この種のイベントを受け取るように登録されているすべての ContainerListener オブジェクトまたは ContainerAdapter オブジェクトに渡されます。(ContainerAdapter オブジェクトは、ContainerListener インタフェースを実装しています。各リスナーオブジェクトは、イベントの発生時に ContainerEvent を取得します。

導入されたバージョン:

1.1

関連項目:

ContainerAdapter, ContainerListener, 「Tutorial: Writing a Container Listener」, 直列化された形式

フィールドの概要

static int	COMPONENT_ADDED このイベントは、コンテナにコンポーネントが追加されたことを示します。
static int	COMPONENT_REMOVED このイベントは、コンテナからコンポーネントが削除されたことを示します。
static int	CONTAINER_FIRST コンテナイベント識別子に使う整数の範囲にある、最初の番号です。
static int	CONTAINER_LAST コンテナイベント識別子に使う整数の範囲にある、最後の番号です。

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

コンテナイベント識別子に使う整数の範囲にある、最初の番号です。

関連項目:

定数フィールド値

CONTAINER_LAST

public static final int CONTAINER_LAST

コンテナイベント識別子に使う整数の範囲にある、最後の番号です。

関連項目:

定数フィールド値

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 オブジェクトを構築します。

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

パラメータ:

source - イベントの発生元の Component オブジェクト (コンテナ)

id - イベントの型を示す整数

child - 追加または削除されたコンポーネント

例外:

IllegalArgumentException - source が null の場合

メソッドの詳細

getContainer

public Container getContainer()

イベントの発生元を返します。

戻り値:

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

getChild

public Component getChild()

イベントによって影響を受けたコンポーネントを返します。

戻り値:

追加または削除された Component オブジェクト

paramString

public String paramString()

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

オーバーライド:

クラス ComponentEvent 内の paramString

戻り値:

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