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, призначений для використання захоплення.

Зауваження

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)

[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

Вказує, чи був слухач подій, що видаляється, зареєстрований як слухач захоплення чи ні.
Якщо слухач був зареєстрований двічі, один з захопленням і один без, кожен з них повинен бути видалений окремо.
Видалення слухача захоплення не впливає на версію того самого слухача без захоплення, і навпаки.