モジュール java.desktop
パッケージ java.awt.event

クラスWindowEvent

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

    public class WindowEvent
extends ComponentEvent
    ウィンドウの状態が変わったことを示す低レベル・イベントです。 この低レベル・イベントは、Windowオブジェクトがオープン、クローズ、アクティブ化、非アクティブ化、アイコン化、または非アイコン化されたとき、またはフォーカスがウィンドウの内外に転送されたときに生成されます。

    イベントは、そのウィンドウのaddWindowListenerメソッドを使ってこれらのイベントを受け取るように登録されている、すべてのWindowListenerまたはWindowAdapterオブジェクトに渡されます。 (WindowAdapterオブジェクトはWindowListenerインタフェースを実装します。) 各リスナー・オブジェクトは、イベントが発生したときにこのWindowEventを取得します。

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

    導入されたバージョン:
    1.1
    関連項目:
    WindowAdapter, WindowListener, Tutorial: Writing a Window Listener, 直列化された形式

    • フィールドの詳細

      • WINDOW_FIRST

        public static final int WINDOW_FIRST
        ウィンドウ・イベントに使用されるIDの範囲内の最初の番号です。
        関連項目:
        定数フィールド値

      • WINDOW_OPENED

        @Native
public static final int WINDOW_OPENED
        ウィンドウがオープンされたことを示すイベントです。 このイベントは、ウィンドウが最初に可視化されたときにだけ送信されます。
        関連項目:
        定数フィールド値

      • WINDOW_CLOSING

        @Native
public static final int WINDOW_CLOSING
        ウィンドウをクローズしていることを示すイベントです。 このイベントは、ユーザーがウィンドウのシステム・メニューでウィンドウを閉じようとしたときに送信されます。 プログラムがこのイベントを処理する際に明示的にウィンドウを隠したり処置したりしない場合、ウィンドウ・クローズ操作は取り消されます。
        関連項目:
        定数フィールド値

      • WINDOW_CLOSED

        @Native
public static final int WINDOW_CLOSED
        ウィンドウがクローズされたことを示すイベントです。 このイベントは、処置呼出しの結果として表示可能なウィンドウがクローズされた後で送信されます。
        関連項目:
        Component.isDisplayable(), Window.dispose(), 定数フィールド値

      • WINDOW_ICONIFIED

        @Native
public static final int WINDOW_ICONIFIED
        ウィンドウがアイコン化されたことを示すイベントです。 このイベントは、ウィンドウが通常の状態から最小化された状態に変更されたときに送信されます。 多くのプラットフォームにおいて、最小化されたウィンドウは、そのウィンドウのiconImageプロパティで指定されたアイコンとして表示されます。
        関連項目:
        Frame.setIconImage(java.awt.Image)、定数フィールド値

      • WINDOW_DEICONIFIED

        @Native
public static final int WINDOW_DEICONIFIED
        ウィンドウが非アイコン化されたことを示すイベント・タイプです。 このイベントは、ウィンドウが最小化された状態から通常の状態に変更されたときに送信されます。
        関連項目:
        定数フィールド値

      • WINDOW_ACTIVATED

        @Native
public static final int WINDOW_ACTIVATED
        ウィンドウがアクティブ化されたことを示すイベント・タイプです。 このイベントはWindowがアクティブWindowになったときに送信されます。 FrameまたはDialogのみがアクティブWindowになれます。 ネイティブ・ウィンドウ・システムは、アクティブWindowまたはその子を特別な装飾(タイトル・バーのハイライトなど)で示すことができます。 アクティブWindowは常に、フォーカスされたWindow、またはフォーカスされたWindowの所有者である最初のFrameまたはDialogです。
        関連項目:
        定数フィールド値

      • WINDOW_DEACTIVATED

        @Native
public static final int WINDOW_DEACTIVATED
        ウィンドウが非アクティブ化されたことを示すイベント・タイプです。 このイベントはWindowがアクティブWindowでなくなったときに送信されます。 FrameまたはDialogのみがアクティブWindowになれます。 ネイティブ・ウィンドウ・システムは、アクティブWindowまたはその子を特別な装飾(タイトル・バーのハイライトなど)で示すことができます。 アクティブWindowは常に、フォーカスされたWindow、またはフォーカスされたWindowの所有者である最初のFrameまたはDialogです。
        関連項目:
        定数フィールド値

      • WINDOW_GAINED_FOCUS

        @Native
public static final int WINDOW_GAINED_FOCUS
        ウィンドウがフォーカスを取得したことを示すイベント・タイプです。 このイベントは、WindowがフォーカスされたWindowになる(そのWindowまたはそのサブコンポーネントの1つがキーボード・イベントを受け取ることを意味する)ときに送信されます。
        関連項目:
        定数フィールド値

      • WINDOW_LOST_FOCUS

        @Native
public static final int WINDOW_LOST_FOCUS
        ウィンドウがフォーカスを喪失したことを示すイベント・タイプです。 このイベントは、Windowが以降フォーカスされたWindowでなくなる(キーボード・イベントが以降そのWindowまたはそのサブコンポーネントに送信されないことを意味する)ときに送信されます。
        関連項目:
        定数フィールド値

      • WINDOW_STATE_CHANGED

        @Native
public static final int WINDOW_STATE_CHANGED
        ウィンドウの状態が変更されたことを示すイベント・タイプです。 このイベントは、Windowの状態がアイコン化や最大化などによって変更されたときに送信されます。
        導入されたバージョン:
        1.4
        関連項目:
        定数フィールド値

      • WINDOW_LAST

        public static final int WINDOW_LAST
        ウィンドウ・イベントに使用されるIDの範囲内の最後の番号です。
        関連項目:
        定数フィールド値

    • コンストラクタの詳細

      • WindowEvent

        public WindowEvent​(Window source,
                   int id,
                   Window opposite,
                   int oldState,
                   int newState)
        WindowEventオブジェクトを構築します。

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

        パラメータ:
        source - イベントを発生させたWindowオブジェクト
        id - イベントのタイプを示す整数。 許容される値については、WindowEventのクラスの説明を参照してください。
        opposite - フォーカスまたはアクティベーション変更に関連するもう一方のウィンドウ、またはnull
        oldState - ウィンドウ状態変更イベントのウィンドウの、以前の状態。 許容値については#getOldState()を参照してください
        newState - ウィンドウ状態変更イベントのウィンドウの、新しい状態。 許容値については#getNewState()を参照してください
        例外:
        IllegalArgumentException - sourceがnullである場合
        導入されたバージョン:
        1.4
        関連項目:
        getWindow(), AWTEvent.getID(), getOppositeWindow(), getOldState(), getNewState()

      • WindowEvent

        public WindowEvent​(Window source,
                   int id,
                   Window opposite)
        指定された反対WindowでWindowEventオブジェクトを構築します。 反対Windowとは、このフォーカスまたはアクティベーション変更に関連するもう一方のWindowのことです。 WINDOW_ACTIVATEDまたはWINDOW_GAINED_FOCUSイベントの場合、これはアクティベーションまたはフォーカスを喪失したWindowです。 WINDOW_DEACTIVATEDまたはWINDOW_LOST_FOCUSの場合、これはアクティベーションまたはフォーカスを取得したWindowです。 このフォーカス変更が、ネイティブ・アプリケーションで、異なるVM内のJavaアプリケーションで、またはもう一方のWindowなしで発生した場合、反対Windowはnullです。

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

        パラメータ:
        source - イベントを発生させたWindowオブジェクト
        id - イベントのタイプを示す整数。 許容される値については、WindowEventのクラスの説明を参照してください。 このコンストラクタは、WINDOW_ACTIVATED、WINDOW_DEACTIVATED、WINDOW_GAINED_FOCUS、またはWINDOW_LOST_FOCUS. WindowEventタイプ以外では使用されないことが想定されています。これは、他のイベント・タイプの反対Windowは常にnullになるためです。
        opposite - フォーカスまたはアクティベーション変更に関連するもう一方のWindow、またはnull
        例外:
        IllegalArgumentException - sourceがnullである場合
        導入されたバージョン:
        1.4
        関連項目:
        getWindow(), AWTEvent.getID(), getOppositeWindow()

      • WindowEvent

        public WindowEvent​(Window source,
                   int id,
                   int oldState,
                   int newState)
        指定された以前のウィンドウ状態と新しいウィンドウ状態を使用して、WindowEventオブジェクトを構築します。

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

        パラメータ:
        source - イベントを発生させたWindowオブジェクト
        id - イベントのタイプを示す整数。 許容される値については、WindowEventのクラスの説明を参照してください。 このコンストラクタはWINDOW_STATE_CHANGED WindowEventタイプ以外には使用されないことを想定しています。以前のおよび新しいウィンドウ状態がほかのイベント・タイプにとって意味がないためです。
        oldState - 以前のウィンドウ状態を表す整数。 許容値については#getOldState()を参照してください
        newState - 新しいウィンドウ状態を表す整数。 許容値については#getNewState()を参照してください
        例外:
        IllegalArgumentException - sourceがnullである場合
        導入されたバージョン:
        1.4
        関連項目:
        getWindow(), AWTEvent.getID(), getOldState(), getNewState()

      • WindowEvent

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

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

        パラメータ:
        source - イベントを発生させたWindowオブジェクト
        id - イベントのタイプを示す整数。 許容される値については、WindowEventのクラスの説明を参照してください。
        例外:
        IllegalArgumentException - sourceがnullである場合
        関連項目:
        getWindow(), AWTEvent.getID()

    • メソッドの詳細

      • getWindow

        public Window getWindow​()
        イベントの発生元を返します。
        戻り値:
        イベントを発生させたWindowオブジェクト

      • getOppositeWindow

        public Window getOppositeWindow​()
        このフォーカスまたはアクティベーション変更に関連するもう一方のWindowを返します。 WINDOW_ACTIVATEDまたはWINDOW_GAINED_FOCUSイベントの場合、これはアクティベーションまたはフォーカスを喪失したWindowです。 WINDOW_DEACTIVATEDまたはWINDOW_LOST_FOCUSの場合、これはアクティベーションまたはフォーカスを取得したWindowです。 ほかのタイプのWindowEventの場合、またはフォーカスまたはアクティベーション変更がネイティブ・アプリケーションで、異なるVMまたはコンテキストのJavaアプリケーションで、またはもう一方のWindowなしで発生した場合、nullが返されます。
        戻り値:
        フォーカスまたはアクティベーション変更に関連するもう一方のWindow、またはnull
        導入されたバージョン:
        1.4

      • getOldState

        public int getOldState​()
        WINDOW_STATE_CHANGEDイベントの場合、ウィンドウの以前の状態を返します。 状態はビット単位マスクで表されます。
        • NORMAL
          状態ビットが設定されていないことを示します。
        • ICONIFIED
        • MAXIMIZED_HORIZ
        • MAXIMIZED_VERT
        • MAXIMIZED_BOTH
          MAXIMIZED_HORIZとMAXIMIZED_VERTを連結します。
        戻り値:
        以前のウィンドウ状態のビット単位マスク
        導入されたバージョン:
        1.4
        関連項目:
        Frame.getExtendedState()

      • getNewState

        public int getNewState​()
        WINDOW_STATE_CHANGEDイベントの場合、ウィンドウの新しい状態を返します。 状態はビット単位マスクで表されます。
        • NORMAL
          状態ビットが設定されていないことを示します。
        • ICONIFIED
        • MAXIMIZED_HORIZ
        • MAXIMIZED_VERT
        • MAXIMIZED_BOTH
          MAXIMIZED_HORIZとMAXIMIZED_VERTを連結します。
        戻り値:
        新しいウィンドウ状態のビット単位マスク
        導入されたバージョン:
        1.4
        関連項目:
        Frame.getExtendedState()

      • paramString

        public String paramString​()
        このイベントを特定するパラメータ文字列を返します。 このメソッドは、イベント・ログの作成およびデバッグに便利です。
        オーバーライド:
        paramString、クラス: ComponentEvent
        戻り値:
        イベントを特定する文字列とその属性