java.awt.event
Interface WindowListener

All Superinterfaces:
EventListener sample code for java.util.EventListener definition code for java.util.EventListener
All Known Implementing Classes:
AWTEventMulticaster sample code for java.awt.AWTEventMulticaster definition code for java.awt.AWTEventMulticaster , BasicToolBarUI.FrameListener sample code for javax.swing.plaf.basic.BasicToolBarUI.FrameListener definition code for javax.swing.plaf.basic.BasicToolBarUI.FrameListener , JMenu.WinListener sample code for javax.swing.JMenu.WinListener definition code for javax.swing.JMenu.WinListener , WindowAdapter sample code for java.awt.event.WindowAdapter definition code for java.awt.event.WindowAdapter

public interface WindowListener
extends EventListener sample code for java.util.EventListener definition code for 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.

Since:
1.1
See Also:
WindowAdapter sample code for java.awt.event.WindowAdapter definition code for java.awt.event.WindowAdapter , WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent , Tutorial: How to Write Window Listeners

Method Summary
 void windowActivated sample code for java.awt.event.WindowListener.windowActivated(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowActivated(java.awt.event.WindowEvent) (WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent  e)
          Invoked when the Window is set to be the active Window.
 void windowClosed sample code for java.awt.event.WindowListener.windowClosed(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowClosed(java.awt.event.WindowEvent) (WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent  e)
          Invoked when a window has been closed as the result of calling dispose on the window.
 void windowClosing sample code for java.awt.event.WindowListener.windowClosing(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowClosing(java.awt.event.WindowEvent) (WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent  e)
          Invoked when the user attempts to close the window from the window's system menu.
 void windowDeactivated sample code for java.awt.event.WindowListener.windowDeactivated(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowDeactivated(java.awt.event.WindowEvent) (WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent  e)
          Invoked when a Window is no longer the active Window.
 void windowDeiconified sample code for java.awt.event.WindowListener.windowDeiconified(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowDeiconified(java.awt.event.WindowEvent) (WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent  e)
          Invoked when a window is changed from a minimized to a normal state.
 void windowIconified sample code for java.awt.event.WindowListener.windowIconified(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowIconified(java.awt.event.WindowEvent) (WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent  e)
          Invoked when a window is changed from a normal to a minimized state.
 void windowOpened sample code for java.awt.event.WindowListener.windowOpened(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowOpened(java.awt.event.WindowEvent) (WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent  e)
          Invoked the first time a window is made visible.
 

Method Detail

windowOpened sample code for java.awt.event.WindowListener.windowOpened(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowOpened(java.awt.event.WindowEvent)

void windowOpened(WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent  e)
Invoked the first time a window is made visible.


windowClosing sample code for java.awt.event.WindowListener.windowClosing(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowClosing(java.awt.event.WindowEvent)

void windowClosing(WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent  e)
Invoked when the user attempts to close the window from the window's system menu.


windowClosed sample code for java.awt.event.WindowListener.windowClosed(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowClosed(java.awt.event.WindowEvent)

void windowClosed(WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent  e)
Invoked when a window has been closed as the result of calling dispose on the window.


windowIconified sample code for java.awt.event.WindowListener.windowIconified(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowIconified(java.awt.event.WindowEvent)

void windowIconified(WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.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) sample code for java.awt.Frame.setIconImage(java.awt.Image) definition code for java.awt.Frame.setIconImage(java.awt.Image)

windowDeiconified sample code for java.awt.event.WindowListener.windowDeiconified(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowDeiconified(java.awt.event.WindowEvent)

void windowDeiconified(WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.WindowEvent  e)
Invoked when a window is changed from a minimized to a normal state.


windowActivated sample code for java.awt.event.WindowListener.windowActivated(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowActivated(java.awt.event.WindowEvent)

void windowActivated(WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.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 sample code for java.awt.event.WindowListener.windowDeactivated(java.awt.event.WindowEvent) definition code for java.awt.event.WindowListener.windowDeactivated(java.awt.event.WindowEvent)

void windowDeactivated(WindowEvent sample code for java.awt.event.WindowEvent definition code for java.awt.event.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.