- 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 int
WINDOW_ACTIVATED
窗口激活的事件类型。static int
WINDOW_CLOSED
窗口关闭事件。static int
WINDOW_CLOSING
“窗口正在关闭”事件。static int
WINDOW_DEACTIVATED
窗口已停用的事件类型。static int
WINDOW_DEICONIFIED
窗口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.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_CHANGED
WindowEvent
类型,因为先前和新窗口状态对于其他事件类型毫无意义。 -
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
- 结果
- 标识事件及其属性的字符串
-
-