Interface IEventTarget

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

Aspose.Html.Dom.EventTarget-gränssnittet implementeras av alla noder i en implementation som stödjer DOM-händelsemodellen.
Därför kan detta gränssnitt erhållas genom att använda bindingsspecifika typomvandlingsmetoder på en instans av Node-gränssnittet.
Gränssnittet möjliggör registrering och borttagning av händelselyssnare på en Aspose.Html.Dom.EventTarget och vidarebefordran av händelser till den Aspose.Html.Dom.Events.IEventTarget.

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

Metoder

AddEventListener(string, IEventListener)

Denna metod möjliggör registrering av händelselyssnare på händelsemålet.

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

Parametrar

type string

Händelsetypen som användaren registrerar för.

listener IEventListener

Tar ett gränssnitt som implementeras av användaren som innehåller metoderna som ska anropas när händelsen inträffar.

Kommentarer

Om en Aspose.Html.Dom.Events.IEventListener läggs till en Aspose.Html.Dom.EventTarget medan den bearbetar en händelse, kommer den inte att utlösas av de aktuella åtgärderna men kan utlösas under ett senare skede av händelseflödet, såsom bubblingsfasen.

Om flera identiska händelselyssnare registreras på samma Aspose.Html.Dom.EventTarget med samma parametrar, kommer de duplicerade instanserna att kasseras. De orsakar inte att Aspose.Html.Dom.Events.IEventListener anropas två gånger och eftersom de kasseras behöver de inte tas bort med Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener) metoden.

AddEventListener(string, IEventListener, bool)

Denna metod möjliggör registrering av händelselyssnare på händelsemålet.

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

Parametrar

type string

Händelsetypen som användaren registrerar för.

listener IEventListener

Tar ett gränssnitt som implementeras av användaren som innehåller metoderna som ska anropas när händelsen inträffar.

useCapture bool

Om sant, indikerar useCapture att användaren önskar initiera fångst.
Efter att ha initierat fångst kommer alla händelser av den angivna typen att vidarebefordras till den registrerade
Aspose.Html.Dom.Events.IEventListener
innan de vidarebefordras till några händelsemål under dem i trädet.
Händelser som bubblar upp genom trädet kommer inte att utlösa en Aspose.Html.Dom.Events.IEventListener som är avsedd att använda fångst.

Kommentarer

Om en Aspose.Html.Dom.Events.IEventListener läggs till en Aspose.Html.Dom.EventTarget medan den bearbetar en händelse, kommer den inte att utlösas av de aktuella åtgärderna men kan utlösas under ett senare skede av händelseflödet, såsom bubblingsfasen.

Om flera identiska händelselyssnare registreras på samma Aspose.Html.Dom.EventTarget med samma parametrar, kommer de duplicerade instanserna att kasseras. De orsakar inte att Aspose.Html.Dom.Events.IEventListener anropas två gånger och eftersom de kasseras behöver de inte tas bort med Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener) metoden.

DispatchEvent(Event)

Denna metod möjliggör vidarebefordran av händelser till implementationens händelsemodell.

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

Parametrar

event Event

Specificerar händelsetyp, beteende och kontextuell information som ska användas i bearbetningen av händelsen.

Returvärde

bool

Returvärdet av Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) indikerar huruvida någon av lyssnarna som hanterade händelsen anropade Aspose.Html.Dom.Events.Event.PreventDefault.
Om Aspose.Html.Dom.Events.Event.PreventDefault anropades är värdet falskt, annars är värdet sant.

Kommentarer

Händelser som vidarebefordras på detta sätt kommer att ha samma fångst- och bubblande beteende som händelser som vidarebefordras direkt av implementationen.
Målet för händelsen är den Aspose.Html.Dom.EventTarget på vilken Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) anropas.

Undantag

DOMException

RemoveEventListener(string, IEventListener)

Denna metod möjliggör borttagning av händelselyssnare från händelsemålet.
Om en Aspose.Html.Dom.Events.IEventListener tas bort från en Aspose.Html.Dom.EventTarget medan den bearbetar en händelse, kommer den inte att utlösas av de aktuella åtgärderna.
Händelselyssnare kan aldrig anropas efter att de har tagits bort.

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

Parametrar

type string

Specificerar händelsetypen för den Aspose.Html.Dom.Events.IEventListener som tas bort.

listener IEventListener

Aspose.Html.Dom.Events.IEventListener-parametern indikerar den Aspose.Html.Dom.Events.IEventListener som ska tas bort.

RemoveEventListener(string, IEventListener, bool)

Denna metod möjliggör borttagning av händelselyssnare från händelsemålet.
Om en Aspose.Html.Dom.Events.IEventListener tas bort från en Aspose.Html.Dom.EventTarget medan den bearbetar en händelse, kommer den inte att utlösas av de aktuella åtgärderna.
Händelselyssnare kan aldrig anropas efter att de har tagits bort.

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

Parametrar

type string

Specificerar händelsetypen för den Aspose.Html.Dom.Events.IEventListener som tas bort.

listener IEventListener

Aspose.Html.Dom.Events.IEventListener-parametern indikerar den Aspose.Html.Dom.Events.IEventListener som ska tas bort.

useCapture bool

Specificerar om den händelselyssnare som tas bort registrerades som en fångande lyssnare eller inte.
Om en lyssnare registrerades två gånger, en med fångst och en utan, måste varje tas bort separat.
Borttagning av en fångande lyssnare påverkar inte en icke-fångande version av samma lyssnare, och vice versa.