モジュール java.desktop
パッケージ 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, Tutorial: Writing a Component Listener, 直列化された形式

    • フィールドの詳細

      • 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
        戻り値:
        イベントを特定する文字列とその属性