compact2, compact3

org.w3c.dom.events

Interface EventTarget

public interface EventTarget

的 EventTarget接口的实现支持DOM事件模型的所有 Nodes实施。因此，该接口可以通过结合具体的铸造方法获得的 Node接口的实例。该接口允许登记和去除， EventTarget一 EventTarget调度事件的 EventListeners。

又见Document Object Model (DOM) Level 2 Events Specification。

从以下版本开始：

DOM级别2

方法摘要

Modifier and Type	Method and Description
void	addEventListener(String type, EventListener listener, boolean useCapture) 此方法允许在事件目标上的事件侦听器的注册。
boolean	dispatchEvent(Event evt) 此方法允许将事件发送到实现事件模型中。
void	removeEventListener(String type, EventListener listener, boolean useCapture) 此方法允许从事件目标中移除事件侦听器。

方法详细信息

addEventListener

void addEventListener(String type,
                      EventListener listener,
                      boolean useCapture)

此方法允许在事件目标上的事件侦听器的注册。如果一个 EventListener添加到 EventTarget同时处理一个事件，它将不会被当前动作触发但可能引发了后来的事件流阶段，如冒泡阶段。如果有多个相同的 EventListeners
与重复的情况下，被丢弃的相同参数相同的 EventTarget注册。他们不会造成 EventListener被调用两次，因为他们丢弃了他们不需要用 removeEventListener法去除。

参数

type -事件类型为用户注册

listener - listener参数需要一个接口包含的方法是在事件发生时调用用户实现。

useCapture -如果是真的， useCapture表明用户希望进行捕捉。在开始捕捉之后，所有指定类型的事件将被派遣到注册 EventListener之前被派遣到任何 EventTargets在树。这是气泡上升通过树事件不会触发指定使用捕捉的 EventListener。

removeEventListener

void removeEventListener(String type,
                         EventListener listener,
                         boolean useCapture)

此方法允许从事件目标中移除事件侦听器。如果一个 EventListener从 EventTarget删除则是处理一个事件，它将不会被当前动作触发。 EventListeners永远不会被调用后。
calling参数不确定任何目前注册在 EventTarget EventListener没有影响 removeEventListener。

参数

type -指定的 EventListener被删除的事件类型。

listener - EventListener参数表示的 EventListener 被删除。

useCapture -指定 EventListener被注册为捕获听众或不。如果一个侦听器被注册两次，一个捕获和一个没有，每一个都必须单独删除。删除捕获侦听器不影响同一个侦听器的非捕获版本，反之亦然。

dispatchEvent

boolean dispatchEvent(Event evt)
               throws EventException

此方法允许将事件发送到实现事件模型中。以这种方式发送的事件将具有相同的捕获和起泡行为作为执行直接发送的事件。本次活动的目标是 EventTarget上 dispatchEvent叫做。

参数

evt -指定事件类型，行为，和上下文信息用于处理事件。

结果

对 dispatchEvent返回值指示是否处理事件称为 preventDefault听众。如果 preventDefault被称为价值是假的，其他的价值是真实的。

异常

EventException - unspecified_event_type_err：如果 Event类型不是由初始化事件之前 dispatchEvent被指定了。该 Event的类型 null或空字符串规范也会引发此异常。