Class EventTarget

Class EventTarget

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

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

[ComVisible(true)]
[DOMName("EventTarget")]
[DOMObject]
public class EventTarget : DOMObject, INotifyPropertyChanged, IEventTarget, IDisposable

继承

object ← DOMObject ← EventTarget

派生

MediaQueryList, Node

实现

INotifyPropertyChanged, IEventTarget, IDisposable

继承成员

DOMObject.GetPlatformType(), object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

构造函数

EventTarget() 

public EventTarget()

方法

AddEventListener(string, DOMEventHandler, bool)

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

public void AddEventListener(string type, DOMEventHandler handler, bool useCapture)

参数

type string

用户注册的事件类型

handler DOMEventHandler

在事件发生时调用的 Aspose.Html.Dom.Events.DOMEventHandler。

useCapture bool

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

备注

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

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

AddEventListener(string, IEventListener)

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

public void AddEventListener(string type, IEventListener listener)

参数

type string

用户注册的事件类型

listener IEventListener

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

备注

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

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

AddEventListener(string, IEventListener, bool)

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

public 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.Events.IEventListener 添加到 Aspose.Html.Dom.EventTarget，它将不会被当前操作触发，但可能会在事件流的后续阶段触发，例如冒泡阶段。

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

DispatchEvent(Event)

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

public 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

Dispose()

执行与释放、释放或重置非托管资源相关的应用程序定义任务。

public void Dispose()

Dispose(bool)

释放非托管和 - 可选 - 托管资源。

protected virtual void Dispose(bool disposing)

参数

disposing bool

true 释放托管和非托管资源；false 仅释放非托管资源。

RemoveEventListener(string, DOMEventHandler, bool)

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

public void RemoveEventListener(string type, DOMEventHandler handler, bool useCapture)

参数

type string

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

handler DOMEventHandler

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

useCapture bool

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

RemoveEventListener(string, IEventListener)

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

public 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.Events.IEventListener 从 Aspose.Html.Dom.EventTarget 中移除，它将不会被当前操作触发。事件监听器在被移除后永远不能被调用。

public 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

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

 中文