compact2, compact3

org.w3c.dom.events

Interface EventTarget

public interface EventTarget

EventTarget接口由支持DOM事件模型的Nodes中的所有Nodes实现。 因此，可以通过在Node接口的实例上使用绑定特定的转换方法来获得此接口。 该界面允许在EventListeners上注册和删除EventTarget并将事件发送到该EventTarget 。

另见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时它正在处理一个事件，它不会被通过当前操作触发，而是可以在事件流，的稍后阶段如冒泡阶段被触发。
如果多个相同EventListener s的注册在同一EventTarget具有相同参数的重复的实例被丢弃。 它们不会导致EventListener被调用两次，并且由于它们被丢弃，所以不需要使用removeEventListener方法删除它们。

参数

type - 用户正在注册的事件类型

listener - listener参数采用由用户实现的接口，该接口包含事件发生时要调用的方法。

useCapture - 如果为真， useCapture表示用户希望启动捕获。 启动捕获后，指定类型的所有事件将被发送到注册的EventListener然后再将其发送到树下的任何EventTargets 。 通过树上冒泡的事件不会触发指定使用捕获的EventListener 。

removeEventListener

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

此方法允许从事件目标中删除事件侦听器。 如果EventListener是从去除EventTarget时它正在处理一个事件，它不会由当前操作触发。 EventListener被删除后永远不会被调用。
拨打removeEventListener的参数不会识别EventTarget当前EventListener的EventTarget没有任何效果。

参数

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

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

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

dispatchEvent

boolean dispatchEvent(Event evt)
               throws EventException

该方法允许将事件分派到实现事件模型中。 以这种方式发送的事件将具有与实现直接发送的事件相同的捕获和冒泡行为。 该事件的目标是EventTarget上dispatchEvent被调用。

参数

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

结果

dispatchEvent的返回值dispatchEvent处理事件的任何dispatchEvent器是否为preventDefault 。 如果preventDefault被称为值为false，否则该值为true。

异常

EventException - UNSPECIFIED_EVENT_TYPE_ERR：如果Event的类型未通过在dispatchEvent之前dispatchEvent事件指定，则引发。 所述的规范Event的类型为null或空字符串也会触发此异常。