Module java.desktop
Package 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

Modifier and Type
Method
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 Details

### windowOpened

void windowOpened(WindowEvent e)
Invoked the first time a window is made visible.

Parameters:
  `e` - the event to be processed

### windowClosing

void windowClosing(WindowEvent e)
Invoked when the user attempts to close the window from the window's system menu.

Parameters:
  `e` - the event to be processed

### windowClosed

void windowClosed(WindowEvent e)
Invoked when a window has been closed as the result of calling dispose on the window.

Parameters:
  `e` - the event to be processed

### 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.

Parameters:
  `e` - the event to be processed
See Also:
  - `Window.setIconImage(java.awt.Image)`

### windowDeiconified

void windowDeiconified(WindowEvent e)
Invoked when a window is changed from a minimized to a normal state.

Parameters:
  `e` - the event to be processed

### 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.

Parameters:
  `e` - the event to be processed

### 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.

Parameters:
  `e` - the event to be processed