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. }