- 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 - 结果
 - 标识事件及其属性的字符串
 
 
 -  
 
 -