JavaTM 2 Platform
Std. Ed. v1.3

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」, 「参照: Java クラスライブラリ (更新ファイル)」, 直列化された形式

フィールドの概要
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, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK
 
クラス java.util.EventObject から継承したフィールド
source
 
コンストラクタの概要
ContainerEvent(Component source, int id, Component child)
          ContainerEvent オブジェクトを構築します。
 
メソッドの概要
 Component getChild()
          イベントによって影響を受けた Component を返します。
 Container getContainer()
          イベントの発生元を返します。
 String paramString()
          このイベントを特定するパラメータの文字列を返します。
 
クラス java.awt.event.ComponentEvent から継承したメソッド
getComponent
 
クラス java.awt.AWTEvent から継承したメソッド
consume, finalize, getID, isConsumed, toString
 
クラス java.util.EventObject から継承したメソッド
getSource
 
クラス java.lang.Object から継承したメソッド
clone, equals, 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 オブジェクトを構築します。
パラメータ:
source - イベントの発生元の Component オブジェクト (コンテナ)
id - イベントのタイプを示す整数
child - 追加または削除されたコンポーネント
メソッドの詳細

getContainer

public Container getContainer()
イベントの発生元を返します。
戻り値:
イベントの発生元の Container オブジェクト

getChild

public Component getChild()
イベントによって影響を受けた Component を返します。
戻り値:
追加または削除された Component オブジェクト

paramString

public String paramString()
このイベントを特定するパラメータの文字列を返します。このメソッドは、イベントログの作成およびデバッグに使用します。
オーバーライド:
クラス ComponentEvent 内の paramString
戻り値:
イベントを特定する文字列とその属性

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.