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.Events.IEventListener добавляется к Aspose.Html.Dom.EventTarget, пока он обрабатывает событие, он не будет вызван текущими действиями, но может быть вызван на более поздней стадии потока событий, такой как фаза всплытия.

Если несколько идентичных слушателей событий зарегистрированы на одном 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.Events.IEventListener добавляется к Aspose.Html.Dom.EventTarget, пока он обрабатывает событие, он не будет вызван текущими действиями, но может быть вызван на более поздней стадии потока событий, такой как фаза всплытия.

Если несколько идентичных слушателей событий зарегистрированы на одном 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, на котором вызывается Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event).

Исключения

DOMException

RemoveEventListener(string, IEventListener)

Этот метод позволяет удалять слушателей событий из целевого объекта события.
Если Aspose.Html.Dom.Events.IEventListener удаляется из Aspose.Html.Dom.EventTarget, пока он обрабатывает событие, он не будет вызван текущими действиями.
Слушатели событий никогда не могут быть вызваны после их удаления.

[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.Events.IEventListener удаляется из Aspose.Html.Dom.EventTarget, пока он обрабатывает событие, он не будет вызван текущими действиями.
Слушатели событий никогда не могут быть вызваны после их удаления.

[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

Указывает, был ли удаляемый слушатель зарегистрирован как слушатель захвата или нет.
Если слушатель был зарегистрирован дважды, один с захватом и один без, каждый из них должен быть удален отдельно.
Удаление слушателя захвата не влияет на не захватывающую версию того же слушателя и наоборот.