java::awt::event::WindowListener Class Reference

Inheritance diagram for java::awt::event::WindowListener:

Inheritance graph
java::awt::event::WindowAdapterjava::util::EventListenerjava::lang::Interfacejava::lang::Object
[legend]
Collaboration diagram for java::awt::event::WindowListener:

Collaboration graph
java::util::EventListenerjava::lang::Interfacejava::lang::Object
[legend]

List of all members.


Detailed Description

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
Version:
1.19, 01/23/03
See also:
WindowAdapter

WindowEvent

Tutorial: Writing a Window Listener

Reference: The Java Class Libraries (update file)

Since:
1.1

Public Member Functions

virtual void windowOpened (const WindowEvent &e)=0
 Invoked the first time a window is made visible.
virtual void windowClosing (const WindowEvent &e)=0
 Invoked when the user attempts to close the window from the window's system menu.
virtual void windowClosed (const WindowEvent &e)=0
 Invoked when a window has been closed as the result of calling dispose on the window.
virtual void windowIconified (const WindowEvent &e)=0
 Invoked when a window is changed from a normal to a minimized state.
virtual void windowDeiconified (const WindowEvent &e)=0
 Invoked when a window is changed from a minimized to a normal state.
virtual void windowActivated (const WindowEvent &e)=0
 Invoked when the Window is set to be the active Window.
virtual void windowDeactivated (const WindowEvent &e)=0
 Invoked when a Window is no longer the active Window.

Member Function Documentation

virtual void java::awt::event::WindowListener::windowOpened ( const WindowEvent e  )  [pure virtual]

Invoked the first time a window is made visible.

Implemented in java::awt::event::WindowAdapter.

virtual void java::awt::event::WindowListener::windowClosing ( const WindowEvent e  )  [pure virtual]

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

If the program does not explicitly hide or dispose the window while processing this event, the window close operation will be cancelled.

Implemented in java::awt::event::WindowAdapter.

virtual void java::awt::event::WindowListener::windowClosed ( const WindowEvent e  )  [pure virtual]

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

Implemented in java::awt::event::WindowAdapter.

virtual void java::awt::event::WindowListener::windowIconified ( const WindowEvent e  )  [pure virtual]

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:
java.awt.Frame::setIconImage

Implemented in java::awt::event::WindowAdapter.

virtual void java::awt::event::WindowListener::windowDeiconified ( const WindowEvent e  )  [pure virtual]

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

Implemented in java::awt::event::WindowAdapter.

virtual void java::awt::event::WindowListener::windowActivated ( const WindowEvent e  )  [pure virtual]

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.

Implemented in java::awt::event::WindowAdapter.

virtual void java::awt::event::WindowListener::windowDeactivated ( const WindowEvent e  )  [pure virtual]

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.

Implemented in java::awt::event::WindowAdapter.


The documentation for this class was generated from the following file:
Generated on Fri May 16 11:56:20 2008 for CrossPlatformJavaLikeC++API by  doxygen 1.5.3