Interface IEventTarget

Namespace: Aspose.Html.Dom.Events
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 casting spécifiques à la liaison sur une instance de l’interface Node.
L’interface permet l’enregistrement et la suppression d’écouteurs d’événements sur un Aspose.Html.Dom.EventTarget et la distribution d’événements à cet Aspose.Html.Dom.Events.IEventTarget.

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

Méthodes

AddEventListener(string, IEventListener)

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

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

Paramètres

type string

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

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 en cours mais peut être déclenché lors d'une étape ultérieure du flux d'événements, comme la phase de propagation.

Si plusieurs écouteurs d'événements identiques sont enregistrés sur la même Aspose.Html.Dom.EventTarget avec les mêmes paramètres, les instances en double sont rejetées. Ils ne provoquent pas l'appel de l'Aspose.Html.Dom.Events.IEventListener deux fois et comme ils sont rejetés, ils n'ont pas besoin d'être supprimés avec le Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener) méthode.

AddEventListener(string, IEventListener, bool)

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

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

Paramètres

type string

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

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 dispatchés à l’Aspose.Html.Dom.Events.IEventListener enregistré avant d’être dispatchés à toute cible d’événement 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

DispatchEvent(Event)

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

[DOMName("dispatchEvent")]
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.

Renvoie

bool

La valeur de retour de Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) indique si l’un des écouteurs ayant 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 dispatchés de cette manière auront le même comportement de capture et de propagation que les événements dispatché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

RemoveEventListener(string, IEventListener)

Cette méthode permet la suppression d’é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 en cours.
Les écouteurs d’événements ne peuvent jamais être invoqués après avoir été supprimés.

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

Paramètres

type string

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

listener IEventListener

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

RemoveEventListener(string, IEventListener, bool)

[DOMName("removeEventListener")]
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 étant supprimé.

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 étant supprimé 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-capturant du même écouteur, et vice versa.