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

  <interface name="EventCapturer" id="Events-EventCapturer"
      since="DOM Level 2">
    <descr>
    <p>The <code>EventCapturer</code> interface is implemented by <code>Node</code>'s which are
	designated as being able to capture events.
    </p>
    </descr>

    <method name="captureEvent" id="Events-EventCapturer-captureEvent">
     <descr>
     <p>This method is used when a capturing <code>Node</code> wishes to begin
	 capturing a particular type of event. 
     </p>
     </descr>
     <parameters>
      <param name="type" type="DOMString" attr="in">
	  <descr><p>The name of the event to be captured</p></descr>
      </param>
     </parameters>
     <returns type="void">
       <descr><p></p></descr>
     </returns>
     <raises>
      <!-- No exceptions -->
     </raises>
    </method>

    <method name="releaseEvent" id="Events-EventCapturer-releaseEvent">
     <descr>
     <p>This method is used when a capturing <code>Node</code> wishes to cease
	 capturing a particular type of event.
     </p>
     </descr>
     <parameters>
      <param name="type" type="DOMString" attr="in">
	  <descr><p>The name of the event to be released</p></descr>
      </param>
     </parameters>
     <returns type="void">
       <descr><p></p></descr>
     </returns>
     <raises>
      <!-- No exceptions -->
     </raises>
    </method>

    <method name="routeEvent" id="Events-EventCapturer-routeEvent">
     <descr>
     <p>This method is called during the handling of an event by a capturing <code>
	 Node</code> to continue the event's flow to additional event handlers, or if none
	 are present, to the event's target. 
     </p>
     </descr>
     <parameters>
	 </parameters>
     <returns type="void">
       <descr><p></p></descr>
     </returns>
     <raises>
      <!-- Need an exception for when method is called outside of an event listener -->
     </raises>
    </method>

  </interface>


