Java™ Platform
Standard Ed. 6

java.awt.event
Class WindowAdapter

java.lang.Object
  extended by java.awt.event.WindowAdapter
All Implemented Interfaces:
WindowFocusListener, WindowListener, WindowStateListener, EventListener
Direct Known Subclasses:
BasicToolBarUI.FrameListener, JMenu.WinListener

public abstract class WindowAdapter
extends Object
implements WindowListener, WindowStateListener, WindowFocusListener

An abstract adapter class for receiving window events. The methods in this class are empty. This class exists as convenience for creating listener objects.

Extend this class to create a WindowEvent listener and override the methods for the events of interest. (If you implement the WindowListener interface, you have to define all of the methods in it. This abstract class defines null methods for them all, so you can only have to define methods for events you care about.)

Create a listener object using the extended class and then register it 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:
WindowEvent, WindowListener, Tutorial: Writing a Window Listener

Constructor Summary
WindowAdapter()
           
 
Method Summary
 void windowActivated(WindowEvent e)
          Invoked when a window is activated.
 void windowClosed(WindowEvent e)
          Invoked when a window has been closed.
 void windowClosing(WindowEvent e)
          Invoked when a window is in the process of being closed.
 void windowDeactivated(WindowEvent e)
          Invoked when a window is de-activated.
 void windowDeiconified(WindowEvent e)
          Invoked when a window is de-iconified.
 void windowGainedFocus(WindowEvent e)
          Invoked when the Window is set to be the focused Window, which means that the Window, or one of its subcomponents, will receive keyboard events.
 void windowIconified(WindowEvent e)
          Invoked when a window is iconified.
 void windowLostFocus(WindowEvent e)
          Invoked when the Window is no longer the focused Window, which means that keyboard events will no longer be delivered to the Window or any of its subcomponents.
 void windowOpened(WindowEvent e)
          Invoked when a window has been opened.
 void windowStateChanged(WindowEvent e)
          Invoked when a window state is changed.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

WindowAdapter

public WindowAdapter()
Method Detail

windowOpened

public void windowOpened(WindowEvent e)
Invoked when a window has been opened.

Specified by:
windowOpened in interface WindowListener

windowClosing

public void windowClosing(WindowEvent e)
Invoked when a window is in the process of being closed. The close operation can be overridden at this point.

Specified by:
windowClosing in interface WindowListener

windowClosed

public void windowClosed(WindowEvent e)
Invoked when a window has been closed.

Specified by:
windowClosed in interface WindowListener

windowIconified

public void windowIconified(WindowEvent e)
Invoked when a window is iconified.

Specified by:
windowIconified in interface WindowListener
See Also:
Frame.setIconImage(java.awt.Image)

windowDeiconified

public void windowDeiconified(WindowEvent e)
Invoked when a window is de-iconified.

Specified by:
windowDeiconified in interface WindowListener

windowActivated

public void windowActivated(WindowEvent e)
Invoked when a window is activated.

Specified by:
windowActivated in interface WindowListener

windowDeactivated

public void windowDeactivated(WindowEvent e)
Invoked when a window is de-activated.

Specified by:
windowDeactivated in interface WindowListener

windowStateChanged

public void windowStateChanged(WindowEvent e)
Invoked when a window state is changed.

Specified by:
windowStateChanged in interface WindowStateListener
Since:
1.4

windowGainedFocus

public void windowGainedFocus(WindowEvent e)
Invoked when the Window is set to be the focused Window, which means that the Window, or one of its subcomponents, will receive keyboard events.

Specified by:
windowGainedFocus in interface WindowFocusListener
Since:
1.4

windowLostFocus

public void windowLostFocus(WindowEvent e)
Invoked when the Window is no longer the focused Window, which means that keyboard events will no longer be delivered to the Window or any of its subcomponents.

Specified by:
windowLostFocus in interface WindowFocusListener
Since:
1.4

Java™ Platform
Standard Ed. 6

Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.