JavaTM 2
Platform
Std. Ed. v1.4.0

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」, 「Reference: The Java Class Libraries (update file)」, 直列化された形式

フィールドの概要
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 - イベントの発生元の Component オブジェクト (コンテナ)
id - イベントのタイプを示す整数
child - 追加または削除されたコンポーネント
メソッドの詳細

getContainer

public Container getContainer()
イベントの発生元を返します。

戻り値:
イベントの発生元の Container オブジェクト

getChild

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

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

paramString

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

オーバーライド:
クラス ComponentEvent 内の paramString
戻り値:
イベントおよびその属性を特定する文字列

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

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