JavaTM Platform
Standard Ed. 6

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 などのコンポーネントオブジェクトによって生成されます。発生したイベントは、コンポーネントの addComponentListner メソッドを使って、そのようなイベントを受け取るように登録されているすべての ComponentListener オブジェクトまたは ComponentAdapter オブジェクトに渡されます (ComponentAdapter オブジェクトは、ComponentListener インタフェースを実装している)。各リスナーオブジェクトは、イベントが発生したときに ComponentEvent を取得します。

導入されたバージョン:
1.1
関連項目:
ComponentAdapter, ComponentListener, 「Tutorial: Writing a Component Listener」, 直列化された形式

フィールドの概要
static int COMPONENT_FIRST
          コンポーネントイベント識別子に使う整数の範囲にある、最初の番号です。
static int COMPONENT_HIDDEN
          このイベントは、コンポーネントが不可視になったことを示します。
static int COMPONENT_LAST
          コンポーネントイベント識別子に使う整数の範囲にある、最後の番号です。
static int COMPONENT_MOVED
          このイベントは、コンポーネントの位置の変更を示します。
static int COMPONENT_RESIZED
          このイベントは、コンポーネントのサイズの変更を示します。
static 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
コンポーネントイベント識別子に使う整数の範囲にある、最初の番号です。

関連項目:
定数フィールド値

COMPONENT_LAST

public static final int COMPONENT_LAST
コンポーネントイベント識別子に使う整数の範囲にある、最後の番号です。

関連項目:
定数フィールド値

COMPONENT_MOVED

public static final int COMPONENT_MOVED
このイベントは、コンポーネントの位置の変更を示します。

関連項目:
定数フィールド値

COMPONENT_RESIZED

public static final int COMPONENT_RESIZED
このイベントは、コンポーネントのサイズの変更を示します。

関連項目:
定数フィールド値

COMPONENT_SHOWN

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

関連項目:
定数フィールド値

COMPONENT_HIDDEN

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

関連項目:
定数フィールド値
コンストラクタの詳細

ComponentEvent

public ComponentEvent(Component source,
                      int id)
ComponentEvent オブジェクトを構築します。  

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

パラメータ:
source - イベントの発生元の Component
id - イベントの型を示す整数
例外:
IllegalArgumentException - source が null の場合
メソッドの詳細

getComponent

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

戻り値:
イベントの発生元の Component オブジェクト。 オブジェクトが Component でない場合は null

paramString

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

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

JavaTM Platform
Standard Ed. 6

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

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