Class EventTarget

Namespace: Aspose.Html.Dom
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 bindungsspezifischen 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 Dispatchen von Ereignissen an dieses Aspose.Html.Dom.Events.IEventTarget.

[ComVisible(true)]
[DOMName("EventTarget")]
[DOMObject]
public class EventTarget : DOMObject, INotifyPropertyChanged, IEventTarget, IDisposable

Vererbung

object ←
DOMObject ←
EventTarget

Abgeleitet

MediaQueryList,
Node

Implementiert

INotifyPropertyChanged,
IEventTarget,
IDisposable

Vererbte Mitglieder

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

Konstruktoren

EventTarget()

public EventTarget()

Methoden

AddEventListener(string, DOMEventHandler, bool)

Diese Methode ermöglicht die Registrierung von Ereignis-Listenern auf dem Ereignisziel.

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

Parameter

type string

Der Ereignistyp, für den der Benutzer sich registriert

handler DOMEventHandler

Nimmt einen Aspose.Html.Dom.Events.DOMEventHandler, der aufgerufen wird, 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 Ereigniszielobjekte darunter im Baum gesendet werden.
Ereignisse, die nach oben durch den Baum blubbern, lösen keinen Aspose.Html.Dom.Events.IEventListener aus, der für die Verwendung von Capture 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, kann jedoch in einer späteren Phase des Ereignisflusses, wie der Blubberphase, ausgelöst werden.

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

AddEventListener(string, IEventListener)

Diese Methode ermöglicht die Registrierung von Ereignis-Listenern auf dem Ereignisziel.

public void AddEventListener(string type, IEventListener listener)

Parameter

type string

Der Ereignistyp, für den der Benutzer sich registriert

listener IEventListener

Nimmt eine vom Benutzer implementierte Schnittstelle, die die Methoden enthält, die aufgerufen werden, 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, kann jedoch in einer späteren Phase des Ereignisflusses, wie der Blubberphase, ausgelöst werden.

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

AddEventListener(string, IEventListener, bool)

Diese Methode ermöglicht die Registrierung von Ereignis-Listenern auf dem Ereignisziel.

public void AddEventListener(string type, IEventListener listener, bool useCapture)

Parameter

type string

Der Ereignistyp, für den der Benutzer sich registriert

listener IEventListener

Nimmt eine vom Benutzer implementierte Schnittstelle, die die Methoden enthält, die aufgerufen werden, 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 Ereigniszielobjekte darunter im Baum gesendet werden.
Ereignisse, die nach oben durch den Baum blubbern, lösen keinen Aspose.Html.Dom.Events.IEventListener aus, der für die Verwendung von Capture 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, kann jedoch in einer späteren Phase des Ereignisflusses, wie der Blubberphase, ausgelöst werden.

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

DispatchEvent(Event)

Diese Methode ermöglicht das Dispatchen von Ereignissen in das Ereignismodell der Implementierung.

public bool DispatchEvent(Event @event)

Parameter

event Event

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

Gibt zurück

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 dispatcht werden, haben dasselbe Erfassungs- und Blubberverhalten wie Ereignisse, die direkt von der Implementierung dispatcht 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

Dispose()

Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben von nicht verwalteten Ressourcen verbunden sind.

public void Dispose()

Dispose(bool)

Gibt nicht verwaltete und - optional - verwaltete Ressourcen frei.

protected virtual void Dispose(bool disposing)

Parameter

disposing bool

true, um sowohl verwaltete als auch nicht verwaltete Ressourcen freizugeben; false, um nur nicht verwaltete Ressourcen freizugeben.

RemoveEventListener(string, DOMEventHandler, bool)

Diese Methode ermöglicht die Entfernung von Ereignis-Listenern vom Ereignisziel.
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 niemals nach ihrer Entfernung aufgerufen werden.

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

Parameter

type string

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

handler DOMEventHandler

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

useCapture bool

Gibt an, ob der zu entfernende EventListener 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.

RemoveEventListener(string, IEventListener)

Diese Methode ermöglicht die Entfernung von Ereignis-Listenern vom Ereignisziel.
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 niemals nach ihrer Entfernung aufgerufen werden.

public 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 Ereignisziel.
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 niemals nach ihrer Entfernung aufgerufen werden.

public 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 zu entfernende EventListener 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.