モジュール java.desktop

パッケージ java.awt.event

クラスWindowEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.ComponentEvent

java.awt.event.WindowEvent

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

Serializable

public class WindowEvent extends ComponentEvent

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

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

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

導入されたバージョン:

1.1

関連項目:

• WindowAdapter
• WindowListener
• チュートリアル: ウィンドウ・リスナーの記述
• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final int	WINDOW_ACTIVATED	ウィンドウがアクティブ化されたことを示すイベント・タイプです。
static final int	WINDOW_CLOSED	ウィンドウがクローズされたことを示すイベントです。
static final int	WINDOW_CLOSING	ウィンドウをクローズしていることを示すイベントです。
static final int	WINDOW_DEACTIVATED	ウィンドウが非アクティブ化されたことを示すイベント・タイプです。
static final int	WINDOW_DEICONIFIED	ウィンドウが非アイコン化されたことを示すイベント・タイプです。
static final int	WINDOW_FIRST	ウィンドウ・イベントに使用されるIDの範囲内の最初の番号です。
static final int	WINDOW_GAINED_FOCUS	ウィンドウがフォーカスを取得したことを示すイベント・タイプです。
static final int	WINDOW_ICONIFIED	ウィンドウがアイコン化されたことを示すイベントです。
static final int	WINDOW_LAST	ウィンドウ・イベントに使用されるIDの範囲内の最後の番号です。
static final int	WINDOW_LOST_FOCUS	ウィンドウがフォーカスを喪失したことを示すイベント・タイプです。
static final int	WINDOW_OPENED	ウィンドウがオープンされたことを示すイベントです。
static final int	WINDOW_STATE_CHANGED	ウィンドウの状態が変更されたことを示すイベント・タイプです。

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

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

コンストラクタ

コンストラクタ	説明
WindowEvent(Window source, int id)	WindowEventオブジェクトを構築します。
WindowEvent(Window source, int id, int oldState, int newState)	指定された以前のウィンドウ状態と新しいウィンドウ状態を使用して、WindowEventオブジェクトを構築します。
WindowEvent(Window source, int id, Window opposite)	指定された反対WindowでWindowEventオブジェクトを構築します。
WindowEvent(Window source, int id, Window opposite, int oldState, int newState)	WindowEventオブジェクトを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
int	getNewState()	WINDOW_STATE_CHANGEDイベントの場合、ウィンドウの新しい状態を返します。
int	getOldState()	WINDOW_STATE_CHANGEDイベントの場合、ウィンドウの以前の状態を返します。
Window	getOppositeWindow()	このフォーカスまたはアクティベーション変更に関連するもう一方のWindowを返します。
Window	getWindow()	イベントの発生元を返します。
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

フィールド詳細

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プロパティで指定されたアイコンとして表示されます。

関連項目:

• Window.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

戻り値:

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