Interface IEventTarget

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

Die Aspose.Html.Dom.EventTarget-Schnittstelle wird von allen Knoten in einer Implementierung implementiert, die das DOM-Ereignismodell unterstützt.
Daher kann diese Schnittstelle durch die Verwendung von bindungs-spezifischen Casting-Methoden auf einer Instanz der Node-Schnittstelle erhalten werden.
Die Schnittstelle ermöglicht die Registrierung und Entfernung von Ereignis-Listenern auf einem Aspose.Html.Dom.EventTarget und das Auslösen von Ereignissen an dieses Aspose.Html.Dom.Events.IEventTarget.

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

Methoden

AddEventListener(string, IEventListener)

Diese Methode ermöglicht die Registrierung von Ereignis-Listenern am Ereignis-Ziel.

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

Parameter

type string

Der Ereignistyp, für den der Benutzer registriert.

listener IEventListener

Nimmt eine vom Benutzer implementierte Schnittstelle entgegen, die die Methoden enthält, die aufgerufen werden sollen, wenn das Ereignis auftritt.

Bemerkungen

Wenn ein Aspose.Html.Dom.Events.IEventListener zu einem Aspose.Html.Dom.EventTarget hinzugefügt wird, während es ein Ereignis verarbeitet, wird es nicht durch die aktuellen Aktionen ausgelöst, sondern kann in einer späteren Phase des Ereignisflusses, wie der Blasenphase, ausgelöst werden.

Wenn mehrere identische Ereignis-Listener mit denselben Parametern auf demselben Aspose.Html.Dom.EventTarget registriert sind, werden die doppelten Instanzen verworfen. Sie führen nicht dazu, dass der Aspose.Html.Dom.Events.IEventListener zweimal aufgerufen wird, und da sie verworfen werden, müssen sie nicht mit der Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener) Methode entfernt werden.

AddEventListener(string, IEventListener, bool)

Diese Methode ermöglicht die Registrierung von Ereignis-Listenern am Ereignis-Ziel.

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

Parameter

type string

Der Ereignistyp, für den der Benutzer registriert.

listener IEventListener

Nimmt eine vom Benutzer implementierte Schnittstelle entgegen, die die Methoden enthält, die aufgerufen werden sollen, wenn das Ereignis auftritt.

useCapture bool

Wenn true, zeigt useCapture an, dass der Benutzer die Erfassung initiieren möchte.
Nach der Initiierung der Erfassung werden alle Ereignisse des angegebenen Typs an den registrierten
Aspose.Html.Dom.Events.IEventListener
gesendet, bevor sie an andere Ereignisziele darunter im Baum gesendet werden.
Ereignisse, die nach oben durch den Baum blasen, lösen keinen Aspose.Html.Dom.Events.IEventListener aus, der für die Verwendung von Erfassung vorgesehen ist.

Bemerkungen

Wenn ein Aspose.Html.Dom.Events.IEventListener zu einem Aspose.Html.Dom.EventTarget hinzugefügt wird, während es ein Ereignis verarbeitet, wird es nicht durch die aktuellen Aktionen ausgelöst, sondern kann in einer späteren Phase des Ereignisflusses, wie der Blasenphase, ausgelöst werden.

Wenn mehrere identische Ereignis-Listener mit denselben Parametern auf demselben Aspose.Html.Dom.EventTarget registriert sind, werden die doppelten Instanzen verworfen. Sie führen nicht dazu, dass der Aspose.Html.Dom.Events.IEventListener zweimal aufgerufen wird, und da sie verworfen werden, müssen sie nicht mit der Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener) Methode entfernt werden.

DispatchEvent(Event)

Diese Methode ermöglicht das Auslösen von Ereignissen im Ereignismodell der Implementierung.

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

Parameter

event Event

Gibt den Ereignistyp, das Verhalten und kontextuelle Informationen an, die bei der Verarbeitung des Ereignisses verwendet werden sollen.

Rückgabewert

bool

Der Rückgabewert von Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) gibt an, ob einer der Listener, die das Ereignis behandelt haben, Aspose.Html.Dom.Events.Event.PreventDefault aufgerufen hat.
Wenn Aspose.Html.Dom.Events.Event.PreventDefault aufgerufen wurde, ist der Wert false, andernfalls ist der Wert true.

Bemerkungen

Ereignisse, die auf diese Weise ausgelöst werden, haben dasselbe Erfassungs- und Blasverhalten wie Ereignisse, die direkt von der Implementierung ausgelöst werden.
Das Ziel des Ereignisses ist das Aspose.Html.Dom.EventTarget, auf dem Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) aufgerufen wird.

Ausnahmen

DOMException

RemoveEventListener(string, IEventListener)

Diese Methode ermöglicht die Entfernung von Ereignis-Listenern vom Ereignis-Ziel.
Wenn ein Aspose.Html.Dom.Events.IEventListener von einem Aspose.Html.Dom.EventTarget entfernt wird, während es ein Ereignis verarbeitet, wird es nicht durch die aktuellen Aktionen ausgelöst.
Ereignis-Listener können nach ihrer Entfernung niemals aufgerufen werden.

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

Parameter

type string

Gibt den Ereignistyp des Aspose.Html.Dom.Events.IEventListener an, der entfernt wird.

listener IEventListener

Der Aspose.Html.Dom.Events.IEventListener-Parameter gibt den Aspose.Html.Dom.Events.IEventListener an, der entfernt werden soll.

RemoveEventListener(string, IEventListener, bool)

Diese Methode ermöglicht die Entfernung von Ereignis-Listenern vom Ereignis-Ziel.
Wenn ein Aspose.Html.Dom.Events.IEventListener von einem Aspose.Html.Dom.EventTarget entfernt wird, während es ein Ereignis verarbeitet, wird es nicht durch die aktuellen Aktionen ausgelöst.
Ereignis-Listener können nach ihrer Entfernung niemals aufgerufen werden.

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

Parameter

type string

Gibt den Ereignistyp des Aspose.Html.Dom.Events.IEventListener an, der entfernt wird.

listener IEventListener

Der Aspose.Html.Dom.Events.IEventListener-Parameter gibt den Aspose.Html.Dom.Events.IEventListener an, der entfernt werden soll.

useCapture bool

Gibt an, ob der Ereignis-Listener, der entfernt wird, als erfassender Listener registriert war oder nicht.
Wenn ein Listener zweimal registriert wurde, einmal mit Erfassung und einmal ohne, muss jeder separat entfernt werden.
Die Entfernung eines erfassenden Listeners hat keinen Einfluss auf eine nicht-erfassende Version desselben Listeners und umgekehrt.