71 lines
1.9 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Id$ -->
<!-- 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>