java.awt.event

Class WindowEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.ComponentEvent

java.awt.event.WindowEvent

All Implemented Interfaces:

Serializable

public class WindowEvent
extends ComponentEvent

一个低级别的事件，表明一个窗口改变了它的状态。这种低层次的事件是由一个窗口对象时产生的打开，关闭，启动，关闭，图标化，或deiconified，或当焦点转移到或窗外。

事件传递到每一个WindowListener或WindowAdapter对象注册使用窗口的addWindowListener方法接收这样的事件。（WindowAdapter对象实现了WindowListener接口。）每个侦听器对象被这WindowEvent事件发生时。

未指定的行为将如果任何特定的WindowEvent实例的id参数不在WINDOW_FIRST到WINDOW_LAST范围造成的。

从以下版本开始：

JDK1.1

另请参见：

WindowAdapter， WindowListener， Tutorial: Writing a Window Listener， Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	WINDOW_ACTIVATED 窗口激活事件类型。
static int	WINDOW_CLOSED 窗口关闭事件。
static int	WINDOW_CLOSING “窗口关闭”事件。
static int	WINDOW_DEACTIVATED 窗口停用事件类型。
static int	WINDOW_DEICONIFIED 窗口deiconified事件类型。
static int	WINDOW_FIRST 用于窗口事件的入侵检测系统的第一个数字。
static int	WINDOW_GAINED_FOCUS 窗口获得焦点事件类型。
static int	WINDOW_ICONIFIED 窗口图标化的事件。
static int	WINDOW_LAST 用于窗口事件的入侵检测系统范围内的最后一个数字。
static int	WINDOW_LOST_FOCUS 窗口丢失焦点事件类型。
static int	WINDOW_OPENED 窗口打开事件。
static int	WINDOW_STATE_CHANGED 窗口状态更改事件类型。

Fields inherited from class java.awt.event.ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Fields inherited from class 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

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
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对象。

方法摘要

Modifier and Type	Method and Description
int	getNewState() 对于 WINDOW_STATE_CHANGED事件返回窗口的新状态。
int	getOldState() 对于 WINDOW_STATE_CHANGED事件返回窗口以前的状态。
Window	getOppositeWindow() 返回此焦点或激活更改所涉及的另一个窗口。
Window	getWindow() 返回事件的发起人。
String	paramString() 返回标识此事件的参数字符串。

Methods inherited from class java.awt.event.ComponentEvent

getComponent

Methods inherited from class java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

WINDOW_FIRST

public static final int WINDOW_FIRST

用于窗口事件的入侵检测系统的第一个数字。

另请参见：

Constant Field Values

WINDOW_OPENED

@Native
public static final int WINDOW_OPENED

窗口打开事件。此事件仅在第一次发送一个窗口时被显示。

另请参见：

Constant Field Values

WINDOW_CLOSING

@Native
public static final int WINDOW_CLOSING

“窗口关闭”事件。当用户试图关闭从窗口的系统菜单中的窗口时，此事件将被传递。如果程序没有显式隐藏或处理此事件的窗口，则关闭窗口操作将被取消。

另请参见：

Constant Field Values

WINDOW_CLOSED

@Native
public static final int WINDOW_CLOSED

窗口关闭事件。此事件后显示的窗口已经关闭，作为调用处理结果交付。

另请参见：

Component.isDisplayable()， Window.dispose()， Constant Field Values

WINDOW_ICONIFIED

@Native
public static final int WINDOW_ICONIFIED

窗口图标化的事件。此事件被传递时，窗口已从一个正常的到最小状态。对于许多平台，最小化窗口显示在指定的图标窗口的iconImage财产。

另请参见：

Frame.setIconImage(java.awt.Image)， Constant Field Values

WINDOW_DEICONIFIED

@Native
public static final int WINDOW_DEICONIFIED

窗口deiconified事件类型。此事件被传递时，该窗口已被从最小化到一个正常状态。

另请参见：

Constant Field Values

WINDOW_ACTIVATED

@Native
public static final int WINDOW_ACTIVATED

窗口激活事件类型。当窗口成为活动窗口时，此事件将被传递。只有一个框架或一个对话框可以是活动窗口。本地窗口系统可以表示活动窗口或特殊装饰它的孩子，如突出的标题栏。活动窗口总是要么是聚焦的窗口，要么是一个是聚焦窗口的所有者的第一个框架或对话框。

另请参见：

Constant Field Values

WINDOW_DEACTIVATED

@Native
public static final int WINDOW_DEACTIVATED

窗口停用事件类型。当窗口不再是活动窗口时，此事件将被传递。只有一个框架或一个对话框可以是活动窗口。本地窗口系统可以表示活动窗口或特殊装饰它的孩子，如突出的标题栏。活动窗口总是要么是聚焦的窗口，要么是一个是聚焦窗口的所有者的第一个框架或对话框。

另请参见：

Constant Field Values

WINDOW_GAINED_FOCUS

@Native
public static final int WINDOW_GAINED_FOCUS

窗口获得焦点事件类型。这一事件是交付时，窗口成为焦点窗口，这意味着窗口，或它的一部分，将接收键盘事件。

另请参见：

Constant Field Values

WINDOW_LOST_FOCUS

@Native
public static final int WINDOW_LOST_FOCUS

窗口丢失焦点事件类型。这一事件传递窗时不再聚焦窗口，这意味着键盘事件将不再被传递到窗口或其任何部分。

另请参见：

Constant Field Values

WINDOW_STATE_CHANGED

@Native
public static final int WINDOW_STATE_CHANGED

窗口状态更改事件类型。这一事件是交付时，窗口的状态是由它的图标化美德改变，最大化等。

从以下版本开始：

一点四

另请参见：

Constant Field Values

WINDOW_LAST

public static final int WINDOW_LAST

用于窗口事件的入侵检测系统范围内的最后一个数字。

另请参见：

Constant Field Values

Constructor Detail

WindowEvent

public WindowEvent(Window source,
                   int id,
                   Window opposite,
                   int oldState,
                   int newState)

构建了一个 WindowEvent对象。

该方法抛出一个IllegalArgumentException如果source是null。

参数

source - Window对象产生的事件

id -整数表示事件的类型。在允许值的信息，看到 WindowEvent类的描述

opposite -其他窗口参与焦点或激活的变化，或 null

oldState -窗口状态变化事件的窗口之前的状态。看到 #getOldState()允许值

newState -窗口状态变化事件窗口的新状态。看到 #getNewState()允许值

异常

IllegalArgumentException -如果 source是空的

从以下版本开始：

一点四

另请参见：

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。如果焦点发生变化与本机应用程序，在不同的虚拟机的一个java应用程序，或没有其他 Window，那么相反 null

该方法抛出一个IllegalArgumentException如果source是null。

窗口。

参数

source - Window对象产生的事件

id -整数表示事件的类型。在允许值的信息，看到 WindowEvent类的描述。预计该构造函数将不能用于其他然后 WINDOW_ACTIVATED， WINDOW_DEACTIVATED， WINDOW_GAINED_FOCUS，或 WINDOW_LOST_FOCUS。 WindowEvent类型，因为其他事件类型相反的 Window永远是 null。

opposite参与焦点或激活变化的另 Window，或 null

异常

IllegalArgumentException -如果 source是空的

从以下版本开始：

一点四

另请参见：

getWindow()， AWTEvent.getID()， getOppositeWindow()

WindowEvent

public WindowEvent(Window source,
                   int id,
                   int oldState,
                   int newState)

构建一个与指定窗口的状态 WindowEvent以前和新对象。

该方法抛出一个IllegalArgumentException如果source是null。

参数

source - Window对象产生的事件

id -整数表示事件的类型。在允许值的信息，看到 WindowEvent类的描述。据预计，该构造函数将不能用于其他然后 WINDOW_STATE_CHANGED WindowEvent类型，因为以前的和新的窗口状态是毫无意义的其他事件类型。

oldState代表前面的窗口状态的整数。看到 #getOldState()允许值

newState代表新窗口状态的整数。看到 #getNewState()允许值

异常

IllegalArgumentException -如果 source是空的

从以下版本开始：

一点四

另请参见：

getWindow()， AWTEvent.getID()， getOldState()， getNewState()

WindowEvent

public WindowEvent(Window source,
                   int id)

构建了一个 WindowEvent对象。

该方法抛出一个IllegalArgumentException如果source是null。

参数

source - Window对象产生的事件

id -整数表示事件的类型。在允许值的信息，看到 WindowEvent类的描述。

异常

IllegalArgumentException -如果 source是空的

另请参见：

getWindow()， AWTEvent.getID()

方法详细信息

getWindow

public Window getWindow()

返回事件的发起人。

结果

起源事件的窗口对象

getOppositeWindow

public Window getOppositeWindow()

返回此焦点或激活更改所涉及的另一个窗口。一window_activated或window_gained_focus事件，这是失去激活或焦点的窗口。一window_deactivated或window_lost_focus事件，这是获得激活或焦点的窗口。其他任何类型的窗口事件类，或如果焦点或激活的变化发生与本机应用程序，在不同的虚拟机或上下文的一个java应用程序，或没有其他窗口，则返回null。

结果

另一个窗口中涉及的焦点或激活更改，或空

从以下版本开始：

一点四

getOldState

public int getOldState()

对于 WINDOW_STATE_CHANGED事件返回窗口以前的状态。国家作为一位掩码。

• NORMAL
  indicates没有状态位设置。
• ICONIFIED
• MAXIMIZED_HORIZ
• MAXIMIZED_VERT
• MAXIMIZED_BOTH
  concatenates MAXIMIZED_HORIZ和MAXIMIZED_VERT。

结果

以前的窗口状态的位掩码

从以下版本开始：

一点四

另请参见：

Frame.getExtendedState()

getNewState

public int getNewState()

对于 WINDOW_STATE_CHANGED事件返回窗口的新状态。国家作为一位掩码。

• NORMAL
  indicates没有状态位设置。
• ICONIFIED
• MAXIMIZED_HORIZ
• MAXIMIZED_VERT
• MAXIMIZED_BOTH
  concatenates MAXIMIZED_HORIZ和MAXIMIZED_VERT。

结果

新的窗口状态的位掩码

从以下版本开始：

一点四

另请参见：

Frame.getExtendedState()

paramString

public String paramString()

返回标识此事件的参数字符串。此方法用于事件日志记录和调试是有用的。

重写：

paramString 方法重写，继承类 ComponentEvent

结果

识别事件及其属性的字符串