<?xml version="1.0" encoding="utf-8"?>
<!-- $Id: eventlistener.xml 225913 2001-06-01 11:15:37Z dims $ -->
<!-- Event listener interface -->

<interface id="Events-EventListener" name="EventListener"
  since="DOM Level 2">
  <descr>
    <p>
      The <code>EventListener</code> interface is the primary method for
      handling events. Users implement the <code>EventListener</code> interface
      and register their listener on an <code>EventTarget</code> using the
      <code>AddEventListener</code> method. The users should also remove their
      <code>EventListener</code> from its <code>EventTarget</code> after they
      have completed using the listener.
    </p>
	<p>
	  When a <code>Node</code> is copied using the <code>cloneNode</code> method
	  the <code>EventListener</code>s attached to the source <code>Node</code> are
	  not attached to the copied <code>Node</code>.  If the user wishes the same 
	  <code>EventListener</code>s to be added to the newly created copy the user must add them manually.
    </p>
  </descr>
  
  <method name="handleEvent" id="Events-EventListener-handleEvent">
    <descr>
      <p>
	This method is called whenever an event occurs of the type for which
	the <code> EventListener</code> interface was registered.
      </p>
    </descr>
    <parameters>
      <param name="evt" type="Event" attr="in">
	<descr>
	  <p>
	    The <code>Event</code> contains contextual information about the
	    event. It also contains the <code>stopPropagation</code> and 
	    <code>preventDefault</code> methods which are used in determining the event's flow and default
	    action.
	  </p>
	</descr>
      </param>
    </parameters>
    <returns type="void">
      <descr><p></p></descr>
    </returns>
    <raises>
      <!-- No exceptions -->
    </raises>
  </method>
</interface>
