Class Event
Namespace: Aspose.Html.Dom.Events
Assembly: Aspose.HTML.dll (25.1.0)
L’Aspose.Html.Dom.Events.Event est utilisé pour fournir des informations contextuelles sur un événement au gestionnaire traitant l’événement.
[ComVisible(true)]
[DOMObject]
[DOMName("Event")]
public class Event : DOMObject, INotifyPropertyChangedHéritage
Dérivé
CustomEvent, ErrorEvent, SVGZoomEvent, TimeEvent, UIEvent
Implémente
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()
Remarques
Un objet qui implémente l’Aspose.Html.Dom.Events.Event est généralement passé comme premier paramètre à un gestionnaire d’événements.
Des informations contextuelles plus spécifiques sont passées aux gestionnaires d’événements en dérivant des interfaces supplémentaires de l’Aspose.Html.Dom.Events.Event
qui contiennent des informations directement liées au type d’événement qu’elles accompagnent.
Ces interfaces dérivées sont également implémentées par l’objet passé à l’écouteur d’événements.
Constructeurs
Event(string)
Initialise une nouvelle instance de la classe Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type)Paramètres
type string
Le type d’événement.
Event(string, IDictionary<string, object="">)
Initialise une nouvelle instance de la classe Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type, IDictionary<string, object=""> eventInitDict)Paramètres
type string
Le type d’événement.
eventInitDict IDictionary<string, object>
Le dictionnaire d’initialisation de l’événement.
Champs
AtTargetPhase
La phase actuelle de l’événement est la phase de capture.
[DOMName("AT_TARGET")]
public const ushort AtTargetPhase = 2Valeur du champ
BubblingPhase
La phase actuelle de l’événement est la phase de propagation.
[DOMName("BUBBLING_PHASE")]
public const ushort BubblingPhase = 3Valeur du champ
CapturingPhase
L’événement est actuellement évalué au niveau de l’Aspose.Html.Dom.Events.IEventTarget cible.
[DOMName("CAPTURING_PHASE")]
public const ushort CapturingPhase = 1Valeur du champ
NonePhase
Les événements qui ne sont pas actuellement dispatchés se trouvent dans cette phase.
[DOMName("NONE")]
public const ushort NonePhase = 0Valeur du champ
Propriétés
Bubbles
Utilisé pour indiquer si un événement est ou non un événement de propagation. Si l’événement peut se propager, la valeur est true, sinon la valeur est false.
[DOMName("bubbles")]
public bool Bubbles { get; }Valeur de la propriété
Cancelable
Utilisé pour indiquer si un événement peut avoir son action par défaut empêchée. Si l’action par défaut peut être empêchée, la valeur est true, sinon la valeur est false.
[DOMName("cancelable")]
public bool Cancelable { get; }Valeur de la propriété
CurrentTarget
Utilisé pour indiquer l’Aspose.Html.Dom.Events.IEventTarget dont les Aspose.Html.Dom.Events.IEventListeners sont actuellement en cours de traitement.
Ceci est particulièrement utile pendant la capture et la propagation.
[DOMName("currentTarget")]
[DOMNullable]
public EventTarget CurrentTarget { get; }Valeur de la propriété
DefaultPrevented
Renvoie true si preventDefault() a été invoqué lorsque la valeur de l’attribut cancelable est true, et false sinon.
[DOMName("defaultPrevented")]
public bool DefaultPrevented { get; }Valeur de la propriété
EventPhase
Utilisé pour indiquer quelle phase du flux d’événements est actuellement évaluée.
[DOMName("eventPhase")]
public ushort EventPhase { get; }Valeur de la propriété
IsTrusted
L’attribut isTrusted doit renvoyer la valeur à laquelle il a été initialisé. Lorsqu’un événement est créé, l’attribut doit être initialisé à false.
[DOMName("isTrusted")]
public bool IsTrusted { get; }Valeur de la propriété
Target
Utilisé pour indiquer l’Aspose.Html.Dom.Events.IEventTarget auquel l’événement a été initialement dispatché.
[DOMNullable]
[DOMName("target")]
public EventTarget Target { get; }Valeur de la propriété
TimeStamp
Utilisé pour spécifier le temps (en millisecondes par rapport à l’époque) auquel l’événement a été créé.
En raison du fait que certains systèmes peuvent ne pas fournir cette information, la valeur de timeStamp peut ne pas être disponible pour tous les événements.
Lorsqu’elle n’est pas disponible, une valeur de 0 sera renvoyée.
Des exemples de temps d’époque sont le temps de démarrage du système ou 0:0:0 UTC 1er janvier 1970.
[DOMName("timeStamp")]
public ulong TimeStamp { get; }Valeur de la propriété
Type
Le nom de l’événement (insensible à la casse). Le nom doit être un nom XML.
[DOMName("type")]
public string Type { get; }Valeur de la propriété
Méthodes
InitEvent(string, bool, bool)
La méthode Aspose.Html.Dom.Events.Event.InitEvent(System.String,System.Boolean,System.Boolean) est utilisée pour initialiser la valeur d’un Aspose.Html.Dom.Events.Event créé via l’interface
Aspose.Html.Dom.Events.IDocumentEvent.
[DOMName("initEvent")]
public void InitEvent(string type, bool bubbles, bool cancelable)Paramètres
type string
Le type d’événement.
bubbles bool
si défini sur true [bubbles].
cancelable bool
si défini sur true [cancelable].
Remarques
Cette méthode ne peut être appelée que avant que l’événement n’ait été dispatché via la méthode Aspose.Html.Dom.Events.IEventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event),
bien qu’elle puisse être appelée plusieurs fois pendant cette phase si nécessaire.
Si elle est appelée plusieurs fois, la dernière invocation prévaut.
Si elle est appelée à partir d’une sous-classe de l’interface Event, seules les valeurs spécifiées dans la méthode initEvent sont modifiées, tous les autres attributs restent inchangés.
PreventDefault()
Si un événement est annulable, la méthode Aspose.Html.Dom.Events.Event.PreventDefault est utilisée pour signifier que l’événement doit être annulé,
ce qui signifie que toute action par défaut normalement effectuée par l’implémentation à la suite de l’événement ne se produira pas.
[DOMName("preventDefault")]
public void PreventDefault()Remarques
Si, à n’importe quelle étape du flux d’événements, la méthode Aspose.Html.Dom.Events.Event.PreventDefault est appelée, l’événement est annulé.
Toute action par défaut associée à l’événement ne se produira pas.
Appeler cette méthode pour un événement non annulable n’a aucun effet.
Une fois que Aspose.Html.Dom.Events.Event.PreventDefault a été appelé, il restera en vigueur tout au long de la propagation restante de l’événement.
Cette méthode peut être utilisée à n’importe quelle étape du flux d’événements.
StopImmediatePropagation()
L’invocation de cette méthode empêche l’événement d’atteindre tous les écouteurs d’événements enregistrés après le courant et, lorsqu’il est dispatché dans un arbre, empêche également l’événement d’atteindre d’autres objets.
[DOMName("stopImmediatePropagation")]
public void StopImmediatePropagation()StopPropagation()
La méthode Aspose.Html.Dom.Events.Event.StopPropagation est utilisée pour empêcher la propagation ultérieure d’un événement pendant le flux d’événements.
[DOMName("stopPropagation")]
public void StopPropagation()Remarques
Si cette méthode est appelée par un Aspose.Html.Dom.Events.IEventListener, l’événement cessera de se propager à travers l’arbre.
L’événement sera complètement dispatché à tous les écouteurs sur l’Aspose.Html.Dom.Events.IEventTarget actuel avant que le flux d’événements ne s’arrête.
Cette méthode peut être utilisée à n’importe quelle étape du flux d’événements.
