1 /* 2 * @(#)AWTEventListener.java 1.10 03/12/19 3 * 4 * Copyright 2004 Sun Microsystems, Inc. All rights reserved. 5 * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. 6 */ 7 8 package java.awt.event; 9 10 import java.util.EventListener; 11 import java.awt.AWTEvent; 12 13 /** 14 * The listener interface for receiving notification of events 15 * dispatched to objects that are instances of Component or 16 * MenuComponent or their subclasses. Unlike the other EventListeners 17 * in this package, AWTEventListeners passively observe events 18 * being dispatched in the AWT, system-wide. Most applications 19 * should never use this class; applications which might use 20 * AWTEventListeners include event recorders for automated testing, 21 * and facilities such as the Java Accessibility package. 22 * <p> 23 * The class that is interested in monitoring AWT events 24 * implements this interface, and the object created with that 25 * class is registered with the Toolkit, using the Toolkit's 26 * <code>addAWTEventListener</code> method. When an event is 27 * dispatched anywhere in the AWT, that object's 28 * <code>eventDispatched</code> method is invoked. 29 * 30 * @see java.awt.AWTEvent 31 * @see java.awt.Toolkit#addAWTEventListener 32 * @see java.awt.Toolkit#removeAWTEventListener 33 * 34 * @author Fred Ecks 35 * @version 1.10, 12/19/03 36 * @since 1.2 37 */ 38 public interface AWTEventListener extends EventListener { 39 40 /** 41 * Invoked when an event is dispatched in the AWT. 42 */ 43 public void eventDispatched(AWTEvent event); 44 45 } 46