001 /*
002 * Copyright 1996-2006 Sun Microsystems, Inc. All Rights Reserved.
003 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
004 *
005 * This code is free software; you can redistribute it and/or modify it
006 * under the terms of the GNU General Public License version 2 only, as
007 * published by the Free Software Foundation. Sun designates this
008 * particular file as subject to the "Classpath" exception as provided
009 * by Sun in the LICENSE file that accompanied this code.
010 *
011 * This code is distributed in the hope that it will be useful, but WITHOUT
012 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
013 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
014 * version 2 for more details (a copy is included in the LICENSE file that
015 * accompanied this code).
016 *
017 * You should have received a copy of the GNU General Public License version
018 * 2 along with this work; if not, write to the Free Software Foundation,
019 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
020 *
021 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
022 * CA 95054 USA or visit www.sun.com if you need additional information or
023 * have any questions.
024 */
025
026 package java.awt.event;
027
028 /**
029 * An abstract adapter class for receiving window events.
030 * The methods in this class are empty. This class exists as
031 * convenience for creating listener objects.
032 * <P>
033 * Extend this class to create a <code>WindowEvent</code> listener
034 * and override the methods for the events of interest. (If you implement the
035 * <code>WindowListener</code> interface, you have to define all of
036 * the methods in it. This abstract class defines null methods for them
037 * all, so you can only have to define methods for events you care about.)
038 * <P>
039 * Create a listener object using the extended class and then register it with
040 * a Window using the window's <code>addWindowListener</code>
041 * method. When the window's status changes by virtue of being opened,
042 * closed, activated or deactivated, iconified or deiconified,
043 * the relevant method in the listener
044 * object is invoked, and the <code>WindowEvent</code> is passed to it.
045 *
046 * @see WindowEvent
047 * @see WindowListener
048 * @see <a href="http://java.sun.com/docs/books/tutorial/post1.0/ui/windowlistener.html">Tutorial: Writing a Window Listener</a>
049 *
050 * @author Carl Quinn
051 * @author Amy Fowler
052 * @author David Mendenhall
053 * @version 1.28, 05/05/07
054 * @since 1.1
055 */
056 public abstract class WindowAdapter implements WindowListener,
057 WindowStateListener, WindowFocusListener {
058 /**
059 * Invoked when a window has been opened.
060 */
061 public void windowOpened(WindowEvent e) {
062 }
063
064 /**
065 * Invoked when a window is in the process of being closed.
066 * The close operation can be overridden at this point.
067 */
068 public void windowClosing(WindowEvent e) {
069 }
070
071 /**
072 * Invoked when a window has been closed.
073 */
074 public void windowClosed(WindowEvent e) {
075 }
076
077 /**
078 * Invoked when a window is iconified.
079 */
080 public void windowIconified(WindowEvent e) {
081 }
082
083 /**
084 * Invoked when a window is de-iconified.
085 */
086 public void windowDeiconified(WindowEvent e) {
087 }
088
089 /**
090 * Invoked when a window is activated.
091 */
092 public void windowActivated(WindowEvent e) {
093 }
094
095 /**
096 * Invoked when a window is de-activated.
097 */
098 public void windowDeactivated(WindowEvent e) {
099 }
100
101 /**
102 * Invoked when a window state is changed.
103 * @since 1.4
104 */
105 public void windowStateChanged(WindowEvent e) {
106 }
107
108 /**
109 * Invoked when the Window is set to be the focused Window, which means
110 * that the Window, or one of its subcomponents, will receive keyboard
111 * events.
112 *
113 * @since 1.4
114 */
115 public void windowGainedFocus(WindowEvent e) {
116 }
117
118 /**
119 * Invoked when the Window is no longer the focused Window, which means
120 * that keyboard events will no longer be delivered to the Window or any of
121 * its subcomponents.
122 *
123 * @since 1.4
124 */
125 public void windowLostFocus(WindowEvent e) {
126 }
127 }
|