Class EventTarget

Namespace: Aspose.Html.Dom
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ého typování 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)]
[DOMName("EventTarget")]
[DOMObject]
public class EventTarget : DOMObject, INotifyPropertyChanged, IEventTarget, IDisposable

Dědění

object ←
DOMObject ←
EventTarget

Odvozené

MediaQueryList,
Node

Implementuje

INotifyPropertyChanged,
IEventTarget,
IDisposable

Děděné členy

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

Konstruktor

EventTarget()

public EventTarget()

Metody

AddEventListener(string, DOMEventHandler, bool)

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

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

Parametry

type string

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

handler DOMEventHandler

Přijímá Aspose.Html.Dom.Events.DOMEventHandler, který bude zavolán, když k události dojde.

useCapture bool

Pokud je true, useCapture naznačuje, že uživatel si přeje 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ílovým událostem pod nimi ve stromu.
Události, které stoupají nahoru stromem, nevyvolají Aspose.Html.Dom.Events.IEventListener určeného pro použití zachytávání.

Poznámky

Pokud je Aspose.Html.Dom.Events.IEventListener přidán k Aspose.Html.Dom.EventTarget, zatímco zpracovává událost, nebude vyvolán aktuálními akcemi, ale může být vyvolán během pozdější fáze toku událostí, jako je 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. Není způsobeno, že by Aspose.Html.Dom.Events.IEventListener byl volán dvakrát, a protože jsou ignorovány, není třeba je odstraňovat pomocí Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean) metody.

AddEventListener(string, IEventListener)

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

public 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, které budou zavolány, když k události dojde.

Poznámky

Pokud je Aspose.Html.Dom.Events.IEventListener přidán k Aspose.Html.Dom.EventTarget, zatímco zpracovává událost, nebude vyvolán aktuálními akcemi, ale může být vyvolán během pozdější fáze toku událostí, jako je 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. Není způsobeno, že by Aspose.Html.Dom.Events.IEventListener byl volán dvakrát, a protože jsou ignorovány, není třeba je odstraňovat pomocí Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean) metody.

AddEventListener(string, IEventListener, bool)

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

public 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, které budou zavolány, když k události dojde.

useCapture bool

Pokud je true, useCapture naznačuje, že uživatel si přeje 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ílovým událostem pod nimi ve stromu.
Události, které stoupají nahoru stromem, nevyvolají Aspose.Html.Dom.Events.IEventListener určeného pro použití zachytávání.

Poznámky

Pokud je Aspose.Html.Dom.Events.IEventListener přidán k Aspose.Html.Dom.EventTarget, zatímco zpracovává událost, nebude vyvolán aktuálními akcemi, ale může být vyvolán během pozdější fáze toku událostí, jako je 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. Není způsobeno, že by Aspose.Html.Dom.Events.IEventListener byl volán dvakrát, a protože jsou ignorovány, není třeba je odstraňovat pomocí Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean) metody.

DispatchEvent(Event)

Tato metoda umožňuje vyvolání událostí v modelu událostí implementace.

public 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 byla Aspose.Html.Dom.Events.Event.PreventDefault zavolána, hodnota je false, jinak je hodnota true.

Poznámky

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

Výjimky

DOMException

Dispose()

Provádí úkoly definované aplikací spojené s uvolněním, uvolněním nebo resetováním neřízených prostředků.

public void Dispose()

Dispose(bool)

Uvolňuje neřízené a - volitelně - řízené prostředky.

protected virtual void Dispose(bool disposing)

Parametry

disposing bool

true pro uvolnění řízených i neřízených prostředků; false pro uvolnění pouze neřízených prostředků.

RemoveEventListener(string, DOMEventHandler, 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, zatímco zpracovává událost, nebude vyvolán aktuálními akcemi.
Posluchače událostí nelze nikdy vyvolat po jejich odstranění.

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

Parametry

type string

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

handler DOMEventHandler

Parametr Aspose.Html.Dom.Events.DOMEventHandler označuje Aspose.Html.Dom.Events.IEventListener, který se má odstranit.

useCapture bool

Určuje, zda byl odstraněný EventListener registrován jako zachytávající posluchač nebo ne.
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í zachytávajícího posluchače neovlivňuje nezachytávající verzi stejného posluchače a naopak.

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, zatímco zpracovává událost, nebude vyvolán aktuálními akcemi.
Posluchače událostí nelze nikdy vyvolat po jejich odstranění.

public 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ý se má odstranit.

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, zatímco zpracovává událost, nebude vyvolán aktuálními akcemi.
Posluchače událostí nelze nikdy vyvolat po jejich odstranění.

public 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ý se má odstranit.

useCapture bool

Určuje, zda byl odstraněný EventListener registrován jako zachytávající posluchač nebo ne.
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í zachytávajícího posluchače neovlivňuje nezachytávající verzi stejného posluchače a naopak.