Interface IEventTarget

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

Rozhraní Aspose.Html.Dom.EventTarget je implementováno všemi uzly v implementaci, která podporuje model událostí DOM.
Toto rozhraní lze získat pomocí metod specifických pro typy na instanci rozhraní Node.
Rozhraní umožňuje registraci a odstranění posluchačů událostí na Aspose.Html.Dom.EventTarget a vyvolání událostí na tom Aspose.Html.Dom.Events.IEventTarget.

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

Metody

AddEventListener(string, IEventListener)

Tato metoda umožňuje registraci posluchačů událostí na cíli události.

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

Parametry

type string

Typ události, pro kterou se uživatel registruje

listener IEventListener

Přijímá rozhraní implementované uživatelem, které obsahuje metody, jež mají být volány, když k události dojde.

Poznámky

Pokud je Aspose.Html.Dom.Events.IEventListener přidán k Aspose.Html.Dom.EventTarget během zpracování události, nebude vyvolán aktuálními akcemi, ale může být vyvolán během pozdější fáze toku události, například během fáze bublání.

Pokud jsou na stejném Aspose.Html.Dom.EventTarget registrovány více identických posluchačů událostí se stejnými parametry, duplicitní instance jsou ignorovány. Nespůsobují, že by Aspose.Html.Dom.Events.IEventListener byl volán dvakrát, a protože jsou ignorovány, nemusí být odstraněny pomocí metody Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).

AddEventListener(string, IEventListener, bool)

Tato metoda umožňuje registraci posluchačů událostí na cíli události.

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

Parametry

type string

Typ události, pro kterou se uživatel registruje

listener IEventListener

Přijímá rozhraní implementované uživatelem, které obsahuje metody, jež mají být volány, když k události dojde.

useCapture bool

Pokud je pravda, useCapture naznačuje, že uživatel chce zahájit zachytávání.
Po zahájení zachytávání budou všechny události specifikovaného typu odeslány registrovanému
Aspose.Html.Dom.Events.IEventListener
před tím, než budou odeslány jakýmkoli cílům události pod nimi ve stromu.
Události, které bublají nahoru stromem, nespustí Aspose.Html.Dom.Events.IEventListener určený k použití zachytávání.

Poznámky

Pokud je Aspose.Html.Dom.Events.IEventListener přidán k Aspose.Html.Dom.EventTarget během zpracování události, nebude vyvolán aktuálními akcemi, ale může být vyvolán během pozdější fáze toku události, například během fáze bublání.

Pokud jsou na stejném Aspose.Html.Dom.EventTarget registrovány více identických posluchačů událostí se stejnými parametry, duplicitní instance jsou ignorovány. Nespůsobují, že by Aspose.Html.Dom.Events.IEventListener byl volán dvakrát, a protože jsou ignorovány, nemusí být odstraněny pomocí metody Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).

DispatchEvent(Event)

Tato metoda umožňuje odesílání událostí do modelu událostí implementace.

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

Parametry

event Event

Specifikuje typ události, chování a kontextové informace, které budou použity při zpracování události.

Návratová hodnota

bool

Návratová hodnota Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) naznačuje, zda některý z posluchačů, kteří zpracovávali událost, zavolal Aspose.Html.Dom.Events.Event.PreventDefault.
Pokud byl Aspose.Html.Dom.Events.Event.PreventDefault zavolán, hodnota je false, jinak je hodnota true.

Poznámky

Události odeslané tímto způsobem budou mít stejné chování zachytávání a bublání jako události odeslané přímo implementací.
Cílem události je Aspose.Html.Dom.EventTarget, na kterém je zavolána Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event).

Výjimky

DOMException

RemoveEventListener(string, IEventListener)

Tato metoda umožňuje odstranění posluchačů událostí z cíle události.
Pokud je Aspose.Html.Dom.Events.IEventListener odstraněn z Aspose.Html.Dom.EventTarget během zpracování události, nebude vyvolán aktuálními akcemi.
Posluchači událostí nemohou být nikdy vyvoláni po odstranění.

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

Parametry

type string

Specifikuje typ události Aspose.Html.Dom.Events.IEventListener, který se odstraňuje.

listener IEventListener

Parametr Aspose.Html.Dom.Events.IEventListener označuje Aspose.Html.Dom.Events.IEventListener, který má být odstraněn.

RemoveEventListener(string, IEventListener, bool)

Tato metoda umožňuje odstranění posluchačů událostí z cíle události.
Pokud je Aspose.Html.Dom.Events.IEventListener odstraněn z Aspose.Html.Dom.EventTarget během zpracování události, nebude vyvolán aktuálními akcemi.
Posluchači událostí nemohou být nikdy vyvoláni po odstranění.

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

Parametry

type string

Specifikuje typ události Aspose.Html.Dom.Events.IEventListener, který se odstraňuje.

listener IEventListener

Parametr Aspose.Html.Dom.Events.IEventListener označuje Aspose.Html.Dom.Events.IEventListener, který má být odstraněn.

useCapture bool

Specifikuje, zda byl odstraňovaný posluchač událostí registrován jako posluchač zachytávání či nikoli.
Pokud byl posluchač registrován dvakrát, jednou se zachytáváním a jednou bez, každý musí být odstraněn samostatně.
Odstranění posluchače zachytávání neovlivňuje nezachytávající verzi stejného posluchače a naopak.