Interface IEventTarget

Interface IEventTarget

Namespace: Aspose.Html.Dom.Events
Assembly: Aspose.HTML.dll (25.1.0)

Aspose.Html.Dom.EventTarget 接口由支持 DOM 事件模型的所有节点实现。
因此，可以通过在 Node 接口的实例上使用特定于绑定的转换方法来获取此接口。
该接口允许在 Aspose.Html.Dom.EventTarget 上注册和移除事件监听器，并将事件分派到该 Aspose.Html.Dom.Events.IEventTarget。

[ComVisible(true)]
[DOMNoInterfaceObject]
public interface IEventTarget

方法

AddEventListener(string, IEventListener)

此方法允许在事件目标上注册事件监听器。

[DOMName("addEventListener")]
void AddEventListener(string type, IEventListener listener)

参数

type string

用户注册的事件类型

listener IEventListener

接受用户实现的接口，该接口包含在事件发生时要调用的方法。

备注

如果在 Aspose.Html.Dom.EventTarget 正在处理事件时添加了 Aspose.Html.Dom.Events.IEventListener，它将不会被当前操作触发，但可能会在事件流的后续阶段（例如冒泡阶段）被触发。

如果在同一 Aspose.Html.Dom.EventTarget 上使用相同参数注册多个相同的事件监听器，则重复的实例将被丢弃。 它们不会导致 Aspose.Html.Dom.Events.IEventListener 被调用两次，并且由于它们被丢弃，因此不需要使用 Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener) 方法将其移除。

AddEventListener(string, IEventListener, bool)

此方法允许在事件目标上注册事件监听器。

[DOMName("addEventListener")]
void AddEventListener(string type, IEventListener listener, bool useCapture)

参数

type string

用户注册的事件类型

listener IEventListener

接受用户实现的接口，该接口包含在事件发生时要调用的方法。

useCapture bool

如果为 true，useCapture 表示用户希望启动捕获。
在启动捕获后，所有指定类型的事件将首先被分派到注册的
Aspose.Html.Dom.Events.IEventListener
然后再分派到树中其下方的任何事件目标。
通过树向上冒泡的事件不会触发指定为使用捕获的 Aspose.Html.Dom.Events.IEventListener。

备注

如果在 Aspose.Html.Dom.EventTarget 正在处理事件时添加了 Aspose.Html.Dom.Events.IEventListener，它将不会被当前操作触发，但可能会在事件流的后续阶段（例如冒泡阶段）被触发。

如果在同一 Aspose.Html.Dom.EventTarget 上使用相同参数注册多个相同的事件监听器，则重复的实例将被丢弃。 它们不会导致 Aspose.Html.Dom.Events.IEventListener 被调用两次，并且由于它们被丢弃，因此不需要使用 Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener) 方法将其移除。

DispatchEvent(Event)

此方法允许将事件分派到实现的事件模型中。

[DOMName("dispatchEvent")]
bool DispatchEvent(Event @event)

参数

event Event

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

返回

bool

Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) 的返回值指示处理事件的任何监听器是否调用了 Aspose.Html.Dom.Events.Event.PreventDefault。
如果调用了 Aspose.Html.Dom.Events.Event.PreventDefault，则值为 false，否则值为 true。

备注

以这种方式分派的事件将具有与直接由实现分派的事件相同的捕获和冒泡行为。
事件的目标是调用 Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) 的 Aspose.Html.Dom.EventTarget。

异常

DOMException

RemoveEventListener(string, IEventListener)

此方法允许从事件目标中移除事件监听器。
如果在 Aspose.Html.Dom.EventTarget 正在处理事件时从中移除 Aspose.Html.Dom.Events.IEventListener，它将不会被当前操作触发。
事件监听器在被移除后永远不会被调用。

[DOMName("removeEventListener")]
void RemoveEventListener(string type, IEventListener listener)

参数

type string

指定要移除的 Aspose.Html.Dom.Events.IEventListener 的事件类型。

listener IEventListener

Aspose.Html.Dom.Events.IEventListener 参数指示要移除的 Aspose.Html.Dom.Events.IEventListener。

RemoveEventListener(string, IEventListener, bool)

此方法允许从事件目标中移除事件监听器。
如果在 Aspose.Html.Dom.EventTarget 正在处理事件时从中移除 Aspose.Html.Dom.Events.IEventListener，它将不会被当前操作触发。
事件监听器在被移除后永远不会被调用。

[DOMName("removeEventListener")]
void RemoveEventListener(string type, IEventListener listener, bool useCapture)

参数

type string

指定要移除的 Aspose.Html.Dom.Events.IEventListener 的事件类型。

listener IEventListener

Aspose.Html.Dom.Events.IEventListener 参数指示要移除的 Aspose.Html.Dom.Events.IEventListener。

useCapture bool

指定被移除的事件监听器是否作为捕获监听器注册。
如果一个监听器被注册了两次，一个是捕获，另一个不是，则每个都必须单独移除。
移除捕获监听器不会影响同一监听器的非捕获版本，反之亦然。

 中文