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