WindowListener (Java Platform SE 8 )
Keywords: java.awt.event.WindowListener interface
Date: 2018-07-01

java.awt.event

## Interface WindowListener

- All Superinterfaces:
    EventListener
  All Known Implementing Classes:
    AWTEventMulticaster, BasicToolBarUI.FrameListener, JMenu.WinListener, WindowAdapter

      public interface WindowListener
      extends EventListener

  The listener interface for receiving window events. The class that is interested in processing a window event either implements this interface (and all the methods it contains) or extends the abstract `WindowAdapter` class (overriding only the methods of interest). The listener object created from that class is then registered with a Window using the window's `addWindowListener` method. When the window's status changes by virtue of being opened, closed, activated or deactivated, iconified or deiconified, the relevant method in the listener object is invoked, and the `WindowEvent` is passed to it.
  Since:
    1.1
  See Also:
    `WindowAdapter`, `WindowEvent`, Tutorial: How to Write Window Listeners

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `windowActivated(WindowEvent e)` Invoked when the Window is set to be the active Window.
    `void` | `windowClosed(WindowEvent e)` Invoked when a window has been closed as the result of calling dispose on the window.
    `void` | `windowClosing(WindowEvent e)` Invoked when the user attempts to close the window from the window's system menu.
    `void` | `windowDeactivated(WindowEvent e)` Invoked when a Window is no longer the active Window.
    `void` | `windowDeiconified(WindowEvent e)` Invoked when a window is changed from a minimized to a normal state.
    `void` | `windowIconified(WindowEvent e)` Invoked when a window is changed from a normal to a minimized state.
    `void` | `windowOpened(WindowEvent e)` Invoked the first time a window is made visible.

- - ### Method Detail

    - #### windowOpened

          void windowOpened(WindowEvent e)

      Invoked the first time a window is made visible.

    - #### windowClosing

          void windowClosing(WindowEvent e)

      Invoked when the user attempts to close the window from the window's system menu.

    - #### windowClosed

          void windowClosed(WindowEvent e)

      Invoked when a window has been closed as the result of calling dispose on the window.

    - #### windowIconified

          void windowIconified(WindowEvent e)

      Invoked when a window is changed from a normal to a minimized state. For many platforms, a minimized window is displayed as the icon specified in the window's iconImage property.
      See Also:
        `Frame.setIconImage(java.awt.Image)`

    - #### windowDeiconified

          void windowDeiconified(WindowEvent e)

      Invoked when a window is changed from a minimized to a normal state.

    - #### windowActivated

          void windowActivated(WindowEvent e)

      Invoked when the Window is set to be the active Window. Only a Frame or a Dialog can be the active Window. The native windowing system may denote the active Window or its children with special decorations, such as a highlighted title bar. The active Window is always either the focused Window, or the first Frame or Dialog that is an owner of the focused Window.

    - #### windowDeactivated

          void windowDeactivated(WindowEvent e)

      Invoked when a Window is no longer the active Window. Only a Frame or a Dialog can be the active Window. The native windowing system may denote the active Window or its children with special decorations, such as a highlighted title bar. The active Window is always either the focused Window, or the first Frame or Dialog that is an owner of the focused Window.

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2018, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.