1. /*

  2.  * @(#)AWTEventListener.java	1.6 00/02/02

  3.  *

  4.  * Copyright 1998-2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. package java.awt.event;

  12. 

  13. import java.util.EventListener;

  14. import java.awt.AWTEvent;

  15. 

  16. /**

  17.  * The listener interface for receiving notification of events

  18.  * dispatched to objects that are instances of Component or

  19.  * MenuComponent or their subclasses.  Unlike the other EventListeners

  20.  * in this package, AWTEventListeners passively observe events

  21.  * being dispatched in the AWT, system-wide.  Most applications

  22.  * should never use this class; applications which might use

  23.  * AWTEventListeners include event recorders for automated testing,

  24.  * and facilities such as the Java Accessibility package.

  25.  * <p>

  26.  * The class that is interested in monitoring AWT events

  27.  * implements this interface, and the object created with that

  28.  * class is registered with the Toolkit, using the Toolkit's

  29.  * <code>addAWTEventListener</code> method.  When an event is

  30.  * dispatched anywhere in the AWT, that object's

  31.  * <code>eventDispatcheded</code> method is invoked.

  32.  *

  33.  * @see java.awt.AWTEvent

  34.  * @see java.awt.Toolkit#addAWTEventListener

  35.  * @see java.awt.Toolkit#removeAWTEventListener

  36.  *

  37.  * @author Fred Ecks

  38.  * @version 1.6, 02/02/00

  39.  * @since 1.2

  40.  */

  41. public interface AWTEventListener extends EventListener {

  42. 

  43.     /**

  44.      * Invoked when an event is dispatched in the AWT.

  45.      */

  46.     public void eventDispatched(AWTEvent event);

  47. 

  48. }