モジュール java.desktop

パッケージ java.awt.event

クラスComponentEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.ComponentEvent

すべての実装されたインタフェース:

Serializable

直系の既知のサブクラス:

ContainerEvent, FocusEvent, InputEvent, PaintEvent, WindowEvent

public class ComponentEvent extends AWTEvent

コンポーネントが移動したこと、サイズを変更したこと、または可視性を変更したことを示す低レベル・イベントです(ほかのコンポーネント・レベル・イベントのルート・クラスでもあります)。

コンポーネント・イベントは、通知のためだけに提供されています。AWTは、コンポーネントの移動およびサイズ変更を内部的に自動的に扱うので、プログラムがこれらのイベントを受け取るかどうかに関係なく、GUIレイアウトは正しく動作します。

このクラスは、ほかのコンポーネント関連イベント(InputEvent、FocusEvent、WindowEvent、ContainerEvent)の基底クラスとして機能する以外に、コンポーネントのサイズ、位置、または可視性の変更を示すイベントを定義します。

この低レベル・イベントは、コンポーネントが移動された、サイズが変更された、不可視にされた、または可視にされたときに、コンポーネント・オブジェクト(Listなど)によって生成されます。 イベントは、そのコンポーネントのaddComponentListenerメソッドを使ってこれらのイベントを受け取るように登録されている、すべてのComponentListenerまたはComponentAdapterオブジェクトに渡されます。 (ComponentAdapterオブジェクトはComponentListenerインタフェースを実装します。) 各リスナー・オブジェクトは、イベントが発生したときにこのComponentEventを取得します。

特定のComponentEventインスタンスのidパラメータがCOMPONENT_FIRSTからCOMPONENT_LASTまでの範囲にない場合に、未指定の動作が発生します。

導入されたバージョン:

1.1

関連項目:

• ComponentAdapter
• ComponentListener
• チュートリアル: コンポーネント・リスナーの記述
• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final int	COMPONENT_FIRST	コンポーネント・イベントに使用されるIDの範囲内の最初の番号です。
static final int	COMPONENT_HIDDEN	このイベントは、コンポーネントが不可視になったことを示します。
static final int	COMPONENT_LAST	コンポーネント・イベントに使用されるIDの範囲内の最後の番号です。
static final int	COMPONENT_MOVED	このイベントは、コンポーネントの位置が変更されたことを示します。
static final int	COMPONENT_RESIZED	このイベントは、コンポーネントのサイズが変更されたことを示します。
static final int	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

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
ComponentEvent(Component source, int id)	ComponentEventオブジェクトを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
Component	getComponent()	イベントの発生元を返します。
String	paramString()	このイベントを特定するパラメータ文字列を返します。

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

フィールド詳細

COMPONENT_FIRST

public static final int COMPONENT_FIRST

コンポーネント・イベントに使用されるIDの範囲内の最初の番号です。

関連項目:

• 定数フィールド値

COMPONENT_LAST

public static final int COMPONENT_LAST

コンポーネント・イベントに使用されるIDの範囲内の最後の番号です。

関連項目:

• 定数フィールド値

COMPONENT_MOVED

@Native public static final int COMPONENT_MOVED

このイベントは、コンポーネントの位置が変更されたことを示します。

関連項目:

• 定数フィールド値

COMPONENT_RESIZED

@Native public static final int COMPONENT_RESIZED

このイベントは、コンポーネントのサイズが変更されたことを示します。

関連項目:

• 定数フィールド値

COMPONENT_SHOWN

@Native public static final int COMPONENT_SHOWN

このイベントは、コンポーネントが可視になったことを示します。

関連項目:

• 定数フィールド値

COMPONENT_HIDDEN

@Native public static final int COMPONENT_HIDDEN

このイベントは、コンポーネントが不可視になったことを示します。

関連項目:

• 定数フィールド値

コンストラクタの詳細

ComponentEvent

public ComponentEvent(Component source, int id)

ComponentEventオブジェクトを構築します。

このメソッドはsourceがnullの場合にIllegalArgumentExceptionをスローします。

パラメータ:

source - イベントを発生させたComponent

id - イベントのタイプを示す整数。 許容される値については、ComponentEventのクラスの説明を参照してください。

例外:

IllegalArgumentException - sourceがnullである場合

関連項目:

• getComponent()
• AWTEvent.getID()

メソッドの詳細

getComponent

public Component getComponent()

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

戻り値:

イベントを発生させたComponentオブジェクト。オブジェクトがComponentでない場合はnull。

paramString

public String paramString()

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

オーバーライド:

paramString、クラスAWTEvent

戻り値:

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