如何编写窗口监听器

本节介绍了如何实现三种与窗口相关的事件处理程序：WindowListener、WindowFocusListener和WindowStateListener。这三个监听器都处理WindowEvent对象。所有三个事件处理程序中的方法都由抽象的WindowAdapter类实现。

当适当的监听器已经在窗口上注册（比如一个frame或dialog），窗口事件会在窗口活动或状态发生后立即触发。如果窗口接收键盘输入，那么该窗口被认为是“焦点所有者”。

以下窗口活动或状态可能在窗口事件之前发生：

• 打开窗口 — 首次显示一个窗口。
• 关闭窗口 — 从屏幕上移除窗口。
• 图标化窗口 — 将窗口缩小为桌面上的图标。
• 取消图标化窗口 — 将窗口恢复到原始大小。
• 焦点窗口 — 包含“焦点拥有者”的窗口。
• 激活窗口（框架或对话框） — 此窗口要么是焦点窗口，要么拥有焦点窗口。
• 非激活窗口 — 此窗口失去了焦点。有关焦点的更多信息，请参阅AWT焦点子系统规范。

• WindowListener接口定义了处理大多数窗口事件的方法，例如打开和关闭窗口的事件，窗口的激活和非激活，以及窗口的图标化和取消图标化。

  另外两个窗口监听器接口是WindowFocusListener和WindowStateListener。WindowFocusListener包含检测窗口成为焦点所有者或失去焦点所有者状态的方法。WindowStateListener只有一个方法，用于检测窗口状态的更改，例如窗口被图标化、取消图标化、最大化或恢复为正常状态。

  虽然您可以使用WindowListener方法来检测一些窗口状态，例如图标化，但使用WindowStateListener可能更好，有两个原因：它只有一个需要您实现的方法，并且它提供了对最大化的支持。

  ---

  注意： 并非所有窗口管理器/本地平台都支持所有窗口状态。可以使用java.awt.Toolkit的方法isFrameStateSupported(int)来确定特定窗口状态是否由特定窗口管理器支持。稍后在本节中描述的WindowEventDemo示例演示了如何使用此方法。

  ---

  窗口监听器通常用于实现自定义的窗口关闭行为。例如，可以使用窗口监听器在关闭窗口之前保存数据，或者在最后一个窗口关闭时退出程序。

  用户不一定需要实现窗口监听器来指定当用户关闭窗口时窗口应该做什么。默认情况下，当用户关闭窗口时，窗口变为不可见。要指定不同的行为，请使用JFrame或JDialog类的setDefaultCloseOperation方法。要实现窗口关闭处理程序，使用setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE)方法，以便窗口监听器提供所有窗口关闭任务。有关如何使用setDefaultCloseOperation的详细信息，请参见响应窗口关闭事件。

  System.exit(int)AWT线程问题

  窗口监听器还常用于在窗口被图标化时停止线程和释放资源，并在窗口取消图标化时重新启动。这样可以避免不必要地使用处理器或其他资源。例如，当包含动画的窗口被图标化时，应停止其动画线程并释放任何大缓冲区。当窗口取消图标化时，可以重新启动线程并重新创建缓冲区。

  以下示例演示了窗口事件。一个不可编辑的文本区域报告了窗口触发的所有窗口事件。该演示实现了WindowListener、WindowFocusListener和WindowStateListener接口中的所有方法。您可以在WindowEventDemo.java中找到演示代码。

  

  ---

  请尝试以下操作: 

  1. 点击“启动”按钮使用Java™ Web Start运行WindowEventDemo（下载JDK 7或更高版本）。或者，如果要自己编译和运行示例，请参考示例索引。
     
  2. 窗口出现时，已显示几条消息。其中一行报告您的窗口管理器是否支持MAXIMIZED_BOTH。如果窗口管理器不支持其他窗口状态，也会报告此条件。接下来，显示了几行，报告窗口的窗口侦听器已接收到窗口打开、激活和获得焦点事件。窗口中显示的所有消息也会发送到标准输出。
  3. 点击另一个窗口。将显示“窗口失去焦点”和“窗口未激活”消息。如果此窗口不是框架或对话框，它将接收到激活或未激活事件。
  4. 点击WindowEventDemo窗口。您将看到“窗口激活”和“窗口获得焦点”消息。
  5. 使用窗口控件将窗口最小化。将显示两条最小化消息，一条来自窗口侦听器，另一条来自窗口状态侦听器。除非您查看标准输出，否则在取消最小化窗口之前，消息不会显示。还报告窗口取消激活和窗口失去焦点事件。
  6. 取消最小化窗口。将显示两条取消最小化消息，一条来自窗口侦听器，另一条来自窗口状态侦听器。WindowStateListener类中的windowStateChanged方法提供了与WindowListener类中的windowIconified和windowDeiconified方法相同的信息。还报告窗口激活和窗口获得焦点事件。
  7. 如果您的外观提供了最大化窗口的方法，请将窗口最大化。请注意，某些外观在某些窗口管理器上运行，例如在dtwm上运行的Java外观，提供了一种最大化窗口的方法，但不会报告任何事件。这是因为dtwm通过调整窗口大小来模拟最大化，但它不是真正的最大化事件。某些外观只提供在垂直或水平方向上最大化窗口的方法。通过使用窗口控件尝试各种选项。
  8. 使用窗口控件关闭窗口。将显示窗口关闭消息。窗口关闭后，会将窗口关闭消息发送到标准输出。

  ---

  这里是演示窗口事件处理的代码：

  窗口监听器 API

  WindowEvent
  • 窗口监听器接口
  • 窗口焦点监听器接口
  • 窗口状态监听器接口
  • 窗口事件类
  WindowAdapter

  窗口监听器接口

  方法	用途
  windowOpened(WindowEvent)	在监听的窗口首次显示后调用。
  windowClosing(WindowEvent)	响应用户请求关闭监听的窗口时调用。要真正关闭窗口，监听器应该调用窗口的 dispose 或 setVisible(false) 方法。
  windowClosed(WindowEvent)	在监听的窗口关闭后调用。
  windowIconified(WindowEvent) windowDeiconified(WindowEvent)	在监听的窗口被最小化或取消最小化后调用。
  windowActivated(WindowEvent) windowDeactivated(WindowEvent)	在监听的窗口被激活或取消激活后调用。这些方法不会发送给非框架或对话框的窗口。因此，最好使用 windowGainedFocus 和 windowLostFocus 方法来确定窗口何时获得或失去焦点。

  WindowFocusListener接口

  方法	目的
  windowGainedFocus(WindowEvent) windowLostFocus(WindowEvent)	在被监听的窗口获得或失去焦点后调用。

  WindowStateListener接口

  方法	目的
  windowStateChanged(WindowEvent)	在被监听的窗口被最小化、还原、最大化或返回正常状态后调用。状态通过WindowEvent以位掩码的形式提供。在java.awt.Frame中定义了可能的值，包括： NORMAL。表示没有状态位被设置。 ICONIFIED。 MAXIMIZED_HORIZ。 MAXIMIZED_VERT。 MAXIMIZED_BOTH。将MAXIMIZED_HORIZ和MAXIMIZED_VERT连接起来。窗口管理器可能支持MAXIMIZED_BOTH，而不支持MAXIMIZED_HORIZ或MAXIMIZED_VERT。可以使用java.awt.Toolkit的方法isFrameStateSupported(int)来确定窗口管理器支持哪些状态。

  WindowEvent类

  方法	目的
  Window getWindow()	返回触发事件的窗口。您可以使用此方法代替 getSource 方法。
  Window getOppositeWindow()	返回与此焦点或激活更改相关的其他窗口。对于 WINDOW_ACTIVATED 或 WINDOW_GAINED_FOCUS 事件，返回失去激活或焦点的窗口。对于 WINDOW_DEACTIVATED 或 WINDOW_LOST_FOCUS 事件，返回获得激活或焦点的窗口。对于带有不同 VM 或上下文中的 Java 应用程序或没有其他窗口的任何其他类型的 WindowEvent，返回 null。
  int getOldState() int getNewState()	对于 WINDOW_STATE_CHANGED 事件，这些方法以位掩码的形式返回窗口的前一个或新状态。

  使用窗口监听器的示例

  示例	描述位置	注释
  WindowEventDemo	本节	报告所有在一个窗口上发生的窗口事件，以演示触发窗口事件的情况。
  SliderDemo	如何使用滑块	监听窗口最小化和恢复事件，以便在窗口不可见时停止动画。
  InternalFrameEventDemo	如何编写内部框架监听器	报告所有在一个内部框架上发生的内部框架事件，以演示触发内部框架事件的情况。内部框架事件类似于窗口事件。
  DialogDemo	文本组件特性	CustomDialog.java 使用 setDefaultCloseOperation 而不是窗口监听器来确定用户关闭窗口时要采取的操作。
  Framework	—	一个演示程序，允许创建和销毁多个窗口。