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

Class WindowEvent

  • 实现的所有接口
    Serializable

    public class WindowEvent
    extends ComponentEvent
    一个低级事件,指示窗口已更改其状态。 当Window对象被打开,关闭,激活,停用,图标化或取消图标化,或者焦点被转移到窗口或从窗口传出时,会生成此低级事件。

    该事件被传递给每个WindowListenerWindowAdapter对象,该对象使用窗口的addWindowListener方法注册接收此类事件。 WindowAdapter对象实现了WindowListener接口。)每个此类侦听器对象在事件发生时获取此WindowEvent

    如果任何特定WindowEvent实例的id参数不在WINDOW_FIRSTWINDOW_LAST范围内, WINDOW_FIRST导致未指定的行为。

    从以下版本开始:
    1.1
    另请参见:
    WindowAdapterWindowListenerTutorial: Writing a Window ListenerSerialized Form
    • 字段详细信息

      • WINDOW_FIRST

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

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

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

        @Native
        public static final int WINDOW_ICONIFIED
        窗口图标化事件。 当窗口从正常状态更改为最小化状态时,将传递此事件。 对于许多平台,最小化窗口显示为窗口的iconImage属性中指定的图标。
        另请参见:
        Window.setIconImage(java.awt.Image)常数字段值
      • 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如果sourcenull

        参数
        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_ACTIVATEDWINDOW_GAINED_FOCUS事件,这是Window失去激活或焦点。 对于WINDOW_DEACTIVATEDWINDOW_LOST_FOCUS事件,这是获得激活或焦点的Window 如果使用本机应用程序,在不同VM中使用Java应用程序或没有其他Window此焦点更改,则相反的窗口为null

        此方法抛出IllegalArgumentException如果sourcenull

        参数
        source - 发起事件的 Window对象
        id - 指示事件类型的整数。 有关允许值的信息,请参阅WindowEvent的类说明。 据预计,此构造将不会被用于其他然后WINDOW_ACTIVATEDWINDOW_DEACTIVATEDWINDOW_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如果sourcenull

        参数
        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如果sourcenull

        参数
        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_HORIZMAXIMIZED_VERT
        结果
        前一个窗口状态的按位掩码
        从以下版本开始:
        1.4
        另请参见:
        Frame.getExtendedState()
      • getNewState

        public int getNewState()
        对于WINDOW_STATE_CHANGED事件,将返回窗口的新状态。 状态表示为按位掩码。
        • NORMAL
          表示未设置状态位。
        • ICONIFIED
        • MAXIMIZED_HORIZ
        • MAXIMIZED_VERT
        • MAXIMIZED_BOTH
          连接MAXIMIZED_HORIZMAXIMIZED_VERT
        结果
        新窗口状态的按位掩码
        从以下版本开始:
        1.4
        另请参见:
        Frame.getExtendedState()
      • paramString

        public String paramString()
        返回标识此事件的参数字符串。 此方法对于事件记录和调试很有用。
        重写:
        paramString在课程 ComponentEvent
        结果
        标识事件及其属性的字符串