- java.lang.Object
-
- java.util.EventObject
-
- java.awt.AWTEvent
-
- java.awt.event.ComponentEvent
-
- java.awt.event.WindowEvent
-
- 实现的所有接口
-
Serializable
public class WindowEvent extends ComponentEvent
一个低级事件,指示窗口已更改其状态。 当Window对象被打开,关闭,激活,停用,图标化或取消图标化,或者焦点被转移到窗口或从窗口传出时,会生成此低级事件。该事件被传递给每个
WindowListener或WindowAdapter对象,该对象使用窗口的addWindowListener方法注册接收此类事件。 (WindowAdapter对象实现了WindowListener接口。)每个此类侦听器对象在事件发生时获取此WindowEvent。如果任何特定
WindowEvent实例的id参数不在WINDOW_FIRST到WINDOW_LAST范围内,WINDOW_FIRST导致未指定的行为。- 从以下版本开始:
- 1.1
- 另请参见:
-
WindowAdapter,WindowListener, Tutorial: Writing a Window Listener , Serialized Form
-
-
字段汇总
字段 变量和类型 字段 描述 static intWINDOW_ACTIVATED窗口激活的事件类型。static intWINDOW_CLOSED窗口关闭事件。static intWINDOW_CLOSING“窗口正在关闭”事件。static intWINDOW_DEACTIVATED窗口已停用的事件类型。static intWINDOW_DEICONIFIED窗口deiconified事件类型。static intWINDOW_FIRST用于窗口事件的id范围中的第一个数字。static intWINDOW_GAINED_FOCUS窗口获得焦点事件类型。static intWINDOW_ICONIFIED窗口图标化事件。static intWINDOW_LAST用于窗口事件的id范围中的最后一个数字。static intWINDOW_LOST_FOCUS窗口丢失焦点事件类型。static intWINDOW_OPENED窗口打开了事件。static intWINDOW_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对象。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 intgetNewState()对于WINDOW_STATE_CHANGED事件,将返回窗口的新状态。intgetOldState()对于WINDOW_STATE_CHANGED事件,返回窗口的先前状态。WindowgetOppositeWindow()返回此焦点或激活更改中涉及的另一个Window。WindowgetWindow()返回事件的发起者。StringparamString()返回标识此事件的参数字符串。-
声明方法的类 java.awt.event.ComponentEvent
getComponent
-
声明方法的类 java.util.EventObject
getSource
-
-
-
-
字段详细信息
-
WINDOW_FIRST
public static final int WINDOW_FIRST
用于窗口事件的id范围中的第一个数字。- 另请参见:
- 常数字段值
-
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_DEICONIFIED
@Native public static final int WINDOW_DEICONIFIED
窗口deiconified事件类型。 当窗口从最小化状态更改为正常状态时,将传递此事件。- 另请参见:
- 常数字段值
-
WINDOW_ACTIVATED
@Native public static final int WINDOW_ACTIVATED
窗口激活的事件类型。 当Window成为活动窗口时,将传递此事件。 只有一个框架或一个对话框可以是活动窗口。 本机窗口系统可以表示具有特殊装饰的活动窗口或其子窗口,例如突出显示的标题栏。 活动窗口始终是聚焦窗口,或者是聚焦窗口所有者的第一个框架或对话框。- 另请参见:
- 常数字段值
-
WINDOW_DEACTIVATED
@Native public static final int WINDOW_DEACTIVATED
窗口已停用的事件类型。 当窗口不再是活动窗口时,将传递此事件。 只有一个框架或一个对话框可以是活动窗口。 本机窗口系统可以表示具有特殊装饰的活动窗口或其子窗口,例如突出显示的标题栏。 活动窗口始终是聚焦窗口,或者是聚焦窗口所有者的第一个框架或对话框。- 另请参见:
- 常数字段值
-
WINDOW_GAINED_FOCUS
@Native public static final int WINDOW_GAINED_FOCUS
窗口获得焦点事件类型。 当Window成为焦点窗口时,将传递此事件,这意味着Window或其子组件之一将接收键盘事件。- 另请参见:
- 常数字段值
-
WINDOW_LOST_FOCUS
@Native public static final int WINDOW_LOST_FOCUS
窗口丢失焦点事件类型。 当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对象。此方法抛出
IllegalArgumentException如果source为null。- 参数
-
source- 发起事件的Window对象 -
id- 指示事件类型的整数。 有关允许值的信息,请参阅WindowEvent的类说明 -
opposite- 焦点或激活更改中涉及的另一个窗口,或null -
oldState- 窗口状态更改事件窗口的上一个状态。 有关允许的值,请参见#getOldState() -
newState- 窗口状态更改事件窗口的新状态。 有关允许的值,请参见#getNewState() - 异常
-
IllegalArgumentException- 如果source为空 - 从以下版本开始:
- 1.4
- 另请参见:
-
getWindow(),AWTEvent.getID(),getOppositeWindow(),getOldState(),getNewState()
-
WindowEvent
public WindowEvent(Window source, int id, Window opposite)
构造一个WindowEvent具有指定相反对象Window。 相反的Window是参与此焦点或激活更改的另一个Window。 对于WINDOW_ACTIVATED或WINDOW_GAINED_FOCUS事件,这是Window失去激活或焦点。 对于WINDOW_DEACTIVATED或WINDOW_LOST_FOCUS事件,这是获得激活或焦点的Window。 如果使用本机应用程序,在不同VM中使用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为空 - 从以下版本开始:
- 1.4
- 另请参见:
-
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_CHANGEDWindowEvent类型,因为先前和新窗口状态对于其他事件类型毫无意义。 -
oldState- 表示上一个窗口状态的整数。 有关允许的值,请参见#getOldState() -
newState- 表示新窗口状态的整数。 有关允许值,请参见#getNewState() - 异常
-
IllegalArgumentException- 如果source为空 - 从以下版本开始:
- 1.4
- 另请参见:
-
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()
返回事件的发起者。- 结果
- 发起事件的Window对象
-
getOppositeWindow
public Window getOppositeWindow()
返回此焦点或激活更改中涉及的另一个Window。 对于WINDOW_ACTIVATED或WINDOW_GAINED_FOCUS事件,这是失去激活或焦点的窗口。 对于WINDOW_DEACTIVATED或WINDOW_LOST_FOCUS事件,这是获得激活或焦点的窗口。 对于任何其他类型的WindowEvent,或者如果本机应用程序发生焦点或激活更改,Java应用程序位于不同的VM或上下文中,或者没有其他Window,则返回null。- 结果
- 参与焦点或激活更改的另一个窗口,或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 - 结果
- 标识事件及其属性的字符串
-
-