模块  java.desktop
软件包  java.awt.event

Class WindowEvent

  • 实现的所有接口
    Serializable 
    public class WindowEventextends 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

    • 字段详细信息

      • WINDOW_FIRST

        public static final int WINDOW_FIRST
        用于窗口事件的id范围中的第一个数字。
        另请参见：
        常数字段值

      • WINDOW_OPENED

        @Nativepublic static final int WINDOW_OPENED
        窗口打开了事件。 仅在窗口第一次可见时才会传递此事件。
        另请参见：
        常数字段值

      • WINDOW_CLOSING

        @Nativepublic static final int WINDOW_CLOSING
        “窗口正在关闭”事件。 当用户尝试从窗口的系统菜单关闭窗口时，将传递此事件。 如果程序在处理此事件时未明确隐藏或处置窗口，则窗口关闭操作将被取消。
        另请参见：
        常数字段值

      • WINDOW_ICONIFIED

        @Nativepublic static final int WINDOW_ICONIFIED
        窗口图标化事件。 当窗口从正常状态更改为最小化状态时，将传递此事件。 对于许多平台，最小化窗口显示为窗口的iconImage属性中指定的图标。
        另请参见：
        Window.setIconImage(java.awt.Image) ， 常数字段值

      • WINDOW_DEICONIFIED

        @Nativepublic static final int WINDOW_DEICONIFIED
        窗口deiconified事件类型。 当窗口从最小化状态更改为正常状态时，将传递此事件。
        另请参见：
        常数字段值

      • WINDOW_ACTIVATED

        @Nativepublic static final int WINDOW_ACTIVATED
        窗口激活的事件类型。 当Window成为活动窗口时，将传递此事件。 只有一个框架或一个对话框可以是活动窗口。 本机窗口系统可以表示具有特殊装饰的活动窗口或其子窗口，例如突出显示的标题栏。 活动窗口始终是聚焦窗口，或者是聚焦窗口所有者的第一个框架或对话框。
        另请参见：
        常数字段值

      • WINDOW_DEACTIVATED

        @Nativepublic static final int WINDOW_DEACTIVATED
        窗口已停用的事件类型。 当窗口不再是活动窗口时，将传递此事件。 只有一个框架或一个对话框可以是活动窗口。 本机窗口系统可以表示具有特殊装饰的活动窗口或其子窗口，例如突出显示的标题栏。 活动窗口始终是聚焦窗口，或者是聚焦窗口所有者的第一个框架或对话框。
        另请参见：
        常数字段值

      • WINDOW_GAINED_FOCUS

        @Nativepublic static final int WINDOW_GAINED_FOCUS
        窗口获得焦点事件类型。 当Window成为焦点窗口时，将传递此事件，这意味着Window或其子组件之一将接收键盘事件。
        另请参见：
        常数字段值

      • WINDOW_LOST_FOCUS

        @Nativepublic static final int WINDOW_LOST_FOCUS
        窗口丢失焦点事件类型。 当Window不再是焦点窗口时，将传递此事件，这意味着键盘事件将不再传递给Window或其任何子组件。
        另请参见：
        常数字段值

      • WINDOW_STATE_CHANGED

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