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 までの範囲にない場合に、未指定の動作が発生します。

導入されたバージョン:

JDK1.1

関連項目:

WindowAdapter, WindowListener, Tutorial: Writing a Window Listener, 直列化された形式

フィールドのサマリー

フィールド

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

public static final int WINDOW_OPENED

ウィンドウがオープンされたことを示すイベントです。このイベントは、ウィンドウが最初に可視化されたときにだけ送信されます。

関連項目:

定数フィールド値

WINDOW_CLOSING

public static final int WINDOW_CLOSING

ウィンドウをクローズしていることを示すイベントです。このイベントは、ユーザーがウィンドウのシステムメニューでウィンドウを閉じようとしたときに送信されます。プログラムがこのイベントを処理する際に明示的にウィンドウを隠したり処置したりしない場合、ウィンドウクローズ操作は取り消されます。

関連項目:

定数フィールド値

WINDOW_CLOSED

public static final int WINDOW_CLOSED

ウィンドウがクローズされたことを示すイベントです。このイベントは、処置呼び出しの結果としてウィンドウがクローズされたあとで送信されます。

関連項目:

定数フィールド値

WINDOW_ICONIFIED

public static final int WINDOW_ICONIFIED

ウィンドウがアイコン化されたことを示すイベントです。このイベントは、ウィンドウが通常の状態から最小化された状態に変更されたときに送信されます。多くのプラットフォームにおいて、最小化されたウィンドウは、そのウィンドウの iconImage プロパティーで指定されたアイコンとして表示されます。

関連項目:

Frame.setIconImage(java.awt.Image)、定数フィールド値

WINDOW_DEICONIFIED

public static final int WINDOW_DEICONIFIED

ウィンドウが非アイコン化されたことを示すイベントタイプです。このイベントは、ウィンドウが最小化された状態から通常の状態に変更されたときに送信されます。

関連項目:

定数フィールド値

WINDOW_ACTIVATED

public static final int WINDOW_ACTIVATED

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

関連項目:

定数フィールド値

WINDOW_DEACTIVATED

public static final int WINDOW_DEACTIVATED

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

関連項目:

定数フィールド値

WINDOW_GAINED_FOCUS

public static final int WINDOW_GAINED_FOCUS

ウィンドウがフォーカスを取得したことを示すイベントタイプです。このイベントは、Window がフォーカスされた Window になる (その Window またはそのサブコンポーネントの 1 つがキーボードイベントを受け取ることを意味する) ときに送信されます。

関連項目:

定数フィールド値

WINDOW_LOST_FOCUS

public static final int WINDOW_LOST_FOCUS

ウィンドウがフォーカスを喪失したことを示すイベントタイプです。このイベントは、Window が以降フォーカスされた Window でなくなる (キーボードイベントが以降その Window またはそのサブコンポーネントに送信されないことを意味する) ときに送信されます。

関連項目:

定数フィールド値

WINDOW_STATE_CHANGED

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

戻り値:

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