WindowListener

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## java.awt.event
Interface WindowListener

All Superinterfaces:
  EventListener

All Known Implementing Classes:
  AWTEventMulticaster, HEventMulticaster, WindowAdapter

    public interface WindowListener

extends 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
Version:
  1.19, 01/23/03
Author:
  Carl Quinn
See Also:
  `WindowAdapter`, `WindowEvent`, Tutorial: Writing a Window Listener, Reference: The Java Class Libraries (update file)

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

Method Detail

### windowOpened

    void windowOpened(WindowEvent e)

  Invoked the first time a window is made visible.

### windowClosing

    void windowClosing(WindowEvent e)

  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.

### windowClosed

    void windowClosed(WindowEvent e)

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

### windowIconified

    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.

  See Also:
    `Frame.setIconImage(java.awt.Image)`

### windowDeiconified

    void windowDeiconified(WindowEvent e)

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

### windowActivated

    void windowActivated(WindowEvent e)

  Invoked when the Window is set to be the active Window. Only a Frame 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 Framethat is an owner of the focused Window.

### windowDeactivated

    void windowDeactivated(WindowEvent e)

  Invoked when a Window is no longer the active Window. Only a Frame 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 that is an owner of the focused Window.

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD