Class WindowAdapter

java.lang.Object

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

Constructors

Modifier	Constructor	Description
protected	WindowAdapter()	Constructs a WindowAdapter.

Method Summary

Modifier and Type	Method	Description
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 declared in class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o)	Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode()	Answers an integer hash code for the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
String	toString()	Answers a string containing a concise, human-readable description of the receiver.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Constructor Details

WindowAdapter

protected WindowAdapter()

Constructs a WindowAdapter.

Method Details

windowOpened

public void windowOpened(WindowEvent e)

Invoked when a window has been opened.

Specified by:

windowOpened in interface WindowListener

Parameters:

e - the event to be processed

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

Parameters:

e - the event to be processed

windowClosed

public void windowClosed(WindowEvent e)

Invoked when a window has been closed.

Specified by:

windowClosed in interface WindowListener

Parameters:

e - the event to be processed

windowIconified

public void windowIconified(WindowEvent e)

Invoked when a window is iconified.

Specified by:

windowIconified in interface WindowListener

Parameters:

e - the event to be processed

See Also:

• Window.setIconImage(Image)

windowDeiconified

public void windowDeiconified(WindowEvent e)

Invoked when a window is de-iconified.

Specified by:

windowDeiconified in interface WindowListener

Parameters:

e - the event to be processed

windowActivated

public void windowActivated(WindowEvent e)

Invoked when a window is activated.

Specified by:

windowActivated in interface WindowListener

Parameters:

e - the event to be processed

windowDeactivated

public void windowDeactivated(WindowEvent e)

Invoked when a window is de-activated.

Specified by:

windowDeactivated in interface WindowListener

Parameters:

e - the event to be processed

windowStateChanged

public void windowStateChanged(WindowEvent e)

Invoked when a window state is changed.

Specified by:

windowStateChanged in interface WindowStateListener

Parameters:

e - the event to be processed

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

Parameters:

e - the event to be processed

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

Parameters:

e - the event to be processed

Since:

1.4