/*
* Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package java.awt.event;
import 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. Author: Carl Quinn See Also: Since: 1.1
/**
* 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 {@code 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 {@code 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
* {@code WindowEvent} is passed to it.
*
* @author Carl Quinn
*
* @see WindowAdapter
* @see WindowEvent
* @see <a href="http://docs.oracle.com/javase/tutorial/uiswing/events/windowlistener.html">Tutorial: How to Write Window Listeners</a>
*
* @since 1.1
*/
public interface WindowListener extends EventListener {
Invoked the first time a window is made visible.
Params: - e – the event to be processed
/**
* Invoked the first time a window is made visible.
* @param e the event to be processed
*/
public void windowOpened(WindowEvent e);
Invoked when the user attempts to close the window
from the window's system menu.
Params: - e – the event to be processed
/**
* Invoked when the user attempts to close the window
* from the window's system menu.
* @param e the event to be processed
*/
public void windowClosing(WindowEvent e);
Invoked when a window has been closed as the result
of calling dispose on the window.
Params: - e – the event to be processed
/**
* Invoked when a window has been closed as the result
* of calling dispose on the window.
* @param e the event to be processed
*/
public void windowClosed(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.
Params: - e – the event to be processed
See Also:
/**
* 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.
* @param e the event to be processed
* @see java.awt.Frame#setIconImage
*/
public void windowIconified(WindowEvent e);
Invoked when a window is changed from a minimized
to a normal state.
Params: - e – the event to be processed
/**
* Invoked when a window is changed from a minimized
* to a normal state.
* @param e the event to be processed
*/
public void windowDeiconified(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.
Params: - e – the event to be processed
/**
* 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.
* @param e the event to be processed
*/
public void windowActivated(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.
Params: - e – the event to be processed
/**
* 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.
* @param e the event to be processed
*/
public void windowDeactivated(WindowEvent e);
}