APIdia Launch Partner
Top Description Methods
java.awt.event

public Interface WindowListener

extends EventListener
Known Direct Implementers
javax.swing.BufferStrategyPaintManager.BufferInfo, javax.swing.SwingUtilities.SharedOwnerFrame, javax.swing.plaf.basic.BasicPopupMenuUI.MouseGrabber, sun.awt.im.InputContext, java.awt.AWTEventMulticaster, java.awt.event.WindowAdapter
Imports
java.util.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.
Author
Carl Quinn
Since
1.1
See Also
WindowAdapter, WindowEvent, Tutorial: How to Write Window Listeners

Method Summary

Modifier and TypeMethod and Description
public void
windowActivated(WindowEvent
the event to be processed
e
)

Invoked when the Window is set to be the active Window.

public void
windowClosed(WindowEvent
the event to be processed
e
)

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

public void
windowClosing(WindowEvent
the event to be processed
e
)

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

public void
windowDeactivated(WindowEvent
the event to be processed
e
)

Invoked when a Window is no longer the active Window.

public void
windowDeiconified(WindowEvent
the event to be processed
e
)

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

public void
windowIconified(WindowEvent
the event to be processed
e
)

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

public void
windowOpened(WindowEvent
the event to be processed
e
)

Invoked the first time a window is made visible.

Method Detail

windowActivatedback to summary
public 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:WindowEvent

the event to be processed

windowClosedback to summary
public void windowClosed(WindowEvent e)

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

Parameters
e:WindowEvent

the event to be processed

windowClosingback to summary
public void windowClosing(WindowEvent e)

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

Parameters
e:WindowEvent

the event to be processed

windowDeactivatedback to summary
public 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:WindowEvent

the event to be processed

windowDeiconifiedback to summary
public void windowDeiconified(WindowEvent e)

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

Parameters
e:WindowEvent

the event to be processed

windowIconifiedback to summary
public 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:WindowEvent

the event to be processed

See Also
java.awt.Frame#setIconImage
windowOpenedback to summary
public void windowOpened(WindowEvent e)

Invoked the first time a window is made visible.

Parameters
e:WindowEvent

the event to be processed