JavaTM 2 Platform
Standard Ed. 5.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 を渡すと、特定できない動作が発生します。このメソッドは sourcenull の場合に IllegalArgumentException をスローします。

パラメータ:
source - イベントの発生元の Component オブジェクト (コンテナ)
id - イベントの型を示す整数
child - 追加または削除されたコンポーネント
例外:
IllegalArgumentException - source が null の場合
メソッドの詳細

getContainer

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

戻り値:
イベントの発生元の Container オブジェクト、または null (オブジェクトが Container でない場合)

getChild

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

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

paramString

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

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

JavaTM 2 Platform
Standard Ed. 5.0

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

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。