Class EventTarget

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

L’interface Aspose.Html.Dom.EventTarget est implémentée par tous les nœuds dans une implémentation qui prend en charge le modèle d’événements DOM.
Par conséquent, cette interface peut être obtenue en utilisant des méthodes de conversion spécifiques au binding sur une instance de l’interface Node.
L’interface permet l’enregistrement et la suppression des écouteurs d’événements sur un Aspose.Html.Dom.EventTarget et la distribution des événements à cet Aspose.Html.Dom.Events.IEventTarget.

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

Héritage

object ← DOMObject ← EventTarget

Dérivé

MediaQueryList, Node

Implémente

INotifyPropertyChanged, IEventTarget, IDisposable

Membres hérités

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

Constructeurs

EventTarget()

public EventTarget()

Méthodes

AddEventListener(string, DOMEventHandler, bool)

Cette méthode permet l’enregistrement des écouteurs d’événements sur la cible d’événement.

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

Paramètres

type string

Le type d’événement pour lequel l’utilisateur s’inscrit

handler DOMEventHandler

Prend un Aspose.Html.Dom.Events.DOMEventHandler à appeler lorsque l’événement se produit.

useCapture bool

Si vrai, useCapture indique que l’utilisateur souhaite initier la capture.
Après avoir initié la capture, tous les événements du type spécifié seront distribués au Aspose.Html.Dom.Events.IEventListener enregistré avant d’être distribués à toute cible d’événements en dessous d’eux dans l’arbre.
Les événements qui remontent dans l’arbre ne déclencheront pas un Aspose.Html.Dom.Events.IEventListener désigné pour utiliser la capture.

Remarques

Si un Aspose.Html.Dom.Events.IEventListener est ajouté à un Aspose.Html.Dom.EventTarget pendant qu'il traite un événement, il ne sera pas déclenché par les actions actuelles mais peut être déclenché lors d'une étape ultérieure du flux d'événements, comme la phase de remontée.

Si plusieurs écouteurs d'événements identiques sont enregistrés sur le même Aspose.Html.Dom.EventTarget avec les mêmes paramètres, les instances en double sont supprimées. Elles ne font pas appel à l'Aspose.Html.Dom.Events.IEventListener deux fois et, puisqu'elles sont supprimées, elles n'ont pas besoin d'être retirées avec la méthode Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean).

AddEventListener(string, IEventListener)

Cette méthode permet l’enregistrement des écouteurs d’événements sur la cible d’événement.

public void AddEventListener(string type, IEventListener listener)

Paramètres

type string

Le type d’événement pour lequel l’utilisateur s’inscrit

listener IEventListener

Prend une interface implémentée par l’utilisateur qui contient les méthodes à appeler lorsque l’événement se produit.

Remarques

Si un Aspose.Html.Dom.Events.IEventListener est ajouté à un Aspose.Html.Dom.EventTarget pendant qu'il traite un événement, il ne sera pas déclenché par les actions actuelles mais peut être déclenché lors d'une étape ultérieure du flux d'événements, comme la phase de remontée.

Si plusieurs écouteurs d'événements identiques sont enregistrés sur le même Aspose.Html.Dom.EventTarget avec les mêmes paramètres, les instances en double sont supprimées. Elles ne font pas appel à l'Aspose.Html.Dom.Events.IEventListener deux fois et, puisqu'elles sont supprimées, elles n'ont pas besoin d'être retirées avec la méthode Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean).

AddEventListener(string, IEventListener, bool)

Cette méthode permet l’enregistrement des écouteurs d’événements sur la cible d’événement.

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

Paramètres

type string

Le type d’événement pour lequel l’utilisateur s’inscrit

listener IEventListener

Prend une interface implémentée par l’utilisateur qui contient les méthodes à appeler lorsque l’événement se produit.

useCapture bool

Si vrai, useCapture indique que l’utilisateur souhaite initier la capture.
Après avoir initié la capture, tous les événements du type spécifié seront distribués au Aspose.Html.Dom.Events.IEventListener enregistré avant d’être distribués à toute cible d’événements en dessous d’eux dans l’arbre.
Les événements qui remontent dans l’arbre ne déclencheront pas un Aspose.Html.Dom.Events.IEventListener désigné pour utiliser la capture.

Remarques

Si un Aspose.Html.Dom.Events.IEventListener est ajouté à un Aspose.Html.Dom.EventTarget pendant qu'il traite un événement, il ne sera pas déclenché par les actions actuelles mais peut être déclenché lors d'une étape ultérieure du flux d'événements, comme la phase de remontée.

Si plusieurs écouteurs d'événements identiques sont enregistrés sur le même Aspose.Html.Dom.EventTarget avec les mêmes paramètres, les instances en double sont supprimées. Elles ne font pas appel à l'Aspose.Html.Dom.Events.IEventListener deux fois et, puisqu'elles sont supprimées, elles n'ont pas besoin d'être retirées avec la méthode Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean).

DispatchEvent(Event)

Cette méthode permet la distribution d’événements dans le modèle d’événements de l’implémentation.

public bool DispatchEvent(Event @event)

Paramètres

event Event

Spécifie le type d’événement, le comportement et les informations contextuelles à utiliser dans le traitement de l’événement.

Retourne

bool

La valeur de retour de Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) indique si l’un des écouteurs qui ont géré l’événement a appelé Aspose.Html.Dom.Events.Event.PreventDefault.
Si Aspose.Html.Dom.Events.Event.PreventDefault a été appelé, la valeur est fausse, sinon la valeur est vraie.

Remarques

Les événements distribués de cette manière auront le même comportement de capture et de remontée que les événements distribués directement par l’implémentation.
La cible de l’événement est l’Aspose.Html.Dom.EventTarget sur lequel Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) est appelé.

Exceptions

DOMException

Dispose()

Effectue les tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non gérées.

public void Dispose()

Dispose(bool)

Libère les ressources non gérées et - en option - gérées.

protected virtual void Dispose(bool disposing)

Paramètres

disposing bool

true pour libérer à la fois les ressources gérées et non gérées ; false pour libérer uniquement les ressources non gérées.

RemoveEventListener(string, DOMEventHandler, bool)

Cette méthode permet la suppression des écouteurs d’événements de la cible d’événement.
Si un Aspose.Html.Dom.Events.IEventListener est supprimé d’un Aspose.Html.Dom.EventTarget pendant qu’il traite un événement, il ne sera pas déclenché par les actions actuelles.
Les écouteurs d’événements ne peuvent jamais être invoqués après avoir été supprimés.

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

Paramètres

type string

Spécifie le type d’événement de l’Aspose.Html.Dom.Events.IEventListener à supprimer.

handler DOMEventHandler

Le paramètre Aspose.Html.Dom.Events.DOMEventHandler indique l’Aspose.Html.Dom.Events.IEventListener à supprimer.

useCapture bool

Spécifie si l’écouteur d’événements à supprimer a été enregistré en tant qu’écouteur de capture ou non.
Si un écouteur a été enregistré deux fois, une fois avec capture et une fois sans, chacun doit être supprimé séparément.
La suppression d’un écouteur de capture n’affecte pas une version non capturée du même écouteur, et vice versa.

RemoveEventListener(string, IEventListener)

Cette méthode permet la suppression des écouteurs d’événements de la cible d’événement.
Si un Aspose.Html.Dom.Events.IEventListener est supprimé d’un Aspose.Html.Dom.EventTarget pendant qu’il traite un événement, il ne sera pas déclenché par les actions actuelles.
Les écouteurs d’événements ne peuvent jamais être invoqués après avoir été supprimés.

public void RemoveEventListener(string type, IEventListener listener)

Paramètres

type string

Spécifie le type d’événement de l’Aspose.Html.Dom.Events.IEventListener à supprimer.

listener IEventListener

Le paramètre Aspose.Html.Dom.Events.IEventListener indique l’Aspose.Html.Dom.Events.IEventListener à supprimer.

RemoveEventListener(string, IEventListener, bool)

Cette méthode permet la suppression des écouteurs d’événements de la cible d’événement.
Si un Aspose.Html.Dom.Events.IEventListener est supprimé d’un Aspose.Html.Dom.EventTarget pendant qu’il traite un événement, il ne sera pas déclenché par les actions actuelles.
Les écouteurs d’événements ne peuvent jamais être invoqués après avoir été supprimés.

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

Paramètres

type string

Spécifie le type d’événement de l’Aspose.Html.Dom.Events.IEventListener à supprimer.

listener IEventListener

Le paramètre Aspose.Html.Dom.Events.IEventListener indique l’Aspose.Html.Dom.Events.IEventListener à supprimer.

useCapture bool

Spécifie si l’écouteur d’événements à supprimer a été enregistré en tant qu’écouteur de capture ou non.
Si un écouteur a été enregistré deux fois, une fois avec capture et une fois sans, chacun doit être supprimé séparément.
La suppression d’un écouteur de capture n’affecte pas une version non capturée du même écouteur, et vice versa.