Class Event

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

L’Aspose.Html.Dom.Events.Event viene utilizzato per fornire informazioni contestuali su un evento al gestore che elabora l’evento.

[ComVisible(true)]
[DOMObject]
[DOMName("Event")]
public class Event : DOMObject, INotifyPropertyChanged

Ereditarietà

object ← DOMObject ← Event

Derivato

CustomEvent, ErrorEvent, SVGZoomEvent, TimeEvent, UIEvent

Implementa

INotifyPropertyChanged

Membri Ereditati

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

Osservazioni

Un oggetto che implementa l’Aspose.Html.Dom.Events.Event viene generalmente passato come primo parametro a un gestore di eventi.
Informazioni contestuali più specifiche vengono passate ai gestori di eventi derivando interfacce aggiuntive da Aspose.Html.Dom.Events.Event
che contengono informazioni direttamente relative al tipo di evento che accompagnano.
Queste interfacce derivate sono implementate anche dall’oggetto passato all’ascoltatore di eventi.

Costruttori

Event(string)

Inizializza una nuova istanza della classe Aspose.Html.Dom.Events.Event.

[DOMConstructor]
public Event(string type)

Parametri

type string

Il tipo di evento.

Event(string, IDictionary<string, object="">)

Inizializza una nuova istanza della classe Aspose.Html.Dom.Events.Event.

[DOMConstructor]
public Event(string type, IDictionary<string, object=""> eventInitDict)

Parametri

type string

Il tipo di evento.

eventInitDict IDictionary<string, object&gt;

Il dizionario di inizializzazione dell’evento.

Campi

AtTargetPhase

La fase attuale dell’evento è la fase di cattura.

[DOMName("AT_TARGET")]
public const ushort AtTargetPhase = 2

Valore del Campo

ushort

BubblingPhase

La fase attuale dell’evento è la fase di bubbling.

[DOMName("BUBBLING_PHASE")]
public const ushort BubblingPhase = 3

Valore del Campo

ushort

CapturingPhase

L’evento viene attualmente valutato presso l’Aspose.Html.Dom.Events.IEventTarget di destinazione.

[DOMName("CAPTURING_PHASE")]
public const ushort CapturingPhase = 1

Valore del Campo

ushort

NonePhase

Gli eventi non attualmente inviati si trovano in questa fase.

[DOMName("NONE")]
public const ushort NonePhase = 0

Valore del Campo

ushort

Proprietà

Bubbles

Utilizzato per indicare se un evento è o meno un evento di bubbling. Se l’evento può fare bubbling, il valore è true, altrimenti il valore è false.

[DOMName("bubbles")]
public bool Bubbles { get; }

Valore della Proprietà

bool

Cancelable

Utilizzato per indicare se un evento può avere la sua azione predefinita impedita. Se l’azione predefinita può essere impedita, il valore è true, altrimenti il valore è false.

[DOMName("cancelable")]
public bool Cancelable { get; }

Valore della Proprietà

bool

CurrentTarget

Utilizzato per indicare l’Aspose.Html.Dom.Events.IEventTarget i cui Aspose.Html.Dom.Events.IEventListeners sono attualmente in fase di elaborazione.
Questo è particolarmente utile durante la cattura e il bubbling.

[DOMName("currentTarget")]
[DOMNullable]
public EventTarget CurrentTarget { get; }

Valore della Proprietà

EventTarget

DefaultPrevented

Restituisce true se preventDefault() è stato invocato mentre il valore dell’attributo cancelable è true, e false altrimenti.

[DOMName("defaultPrevented")]
public bool DefaultPrevented { get; }

Valore della Proprietà

bool

EventPhase

Utilizzato per indicare quale fase del flusso di eventi è attualmente in fase di valutazione.

[DOMName("eventPhase")]
public ushort EventPhase { get; }

Valore della Proprietà

ushort

IsTrusted

L’attributo isTrusted deve restituire il valore a cui è stato inizializzato. Quando un evento viene creato, l’attributo deve essere inizializzato a false.

[DOMName("isTrusted")]
public bool IsTrusted { get; }

Valore della Proprietà

bool

Target

Utilizzato per indicare l’Aspose.Html.Dom.Events.IEventTarget a cui l’evento è stato originariamente inviato.

[DOMNullable]
[DOMName("target")]
public EventTarget Target { get; }

Valore della Proprietà

EventTarget

TimeStamp

Utilizzato per specificare il tempo (in millisecondi rispetto all’epoca) in cui l’evento è stato creato.
A causa del fatto che alcuni sistemi potrebbero non fornire queste informazioni, il valore di timeStamp potrebbe non essere disponibile per tutti gli eventi.
Quando non disponibile, verrà restituito un valore di 0.
Esempi di tempo di epoca sono il tempo di avvio del sistema o 0:0:0 UTC 1° gennaio 1970.

[DOMName("timeStamp")]
public ulong TimeStamp { get; }

Valore della Proprietà

ulong

Type

Il nome dell’evento (case-insensitive). Il nome deve essere un nome XML.

[DOMName("type")]
public string Type { get; }

Valore della Proprietà

string

Metodi

InitEvent(string, bool, bool)

Il metodo Aspose.Html.Dom.Events.Event.InitEvent(System.String,System.Boolean,System.Boolean) viene utilizzato per inizializzare il valore di un Aspose.Html.Dom.Events.Event creato tramite l’interfaccia
Aspose.Html.Dom.Events.IDocumentEvent.

[DOMName("initEvent")]
public void InitEvent(string type, bool bubbles, bool cancelable)

Parametri

type string

Il tipo di evento.

bubbles bool

se impostato su true [bubbles].

cancelable bool

se impostato su true [cancelable].

Osservazioni

Questo metodo può essere chiamato solo prima che l’evento sia stato inviato tramite il metodo Aspose.Html.Dom.Events.IEventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event),
anche se può essere chiamato più volte durante quella fase se necessario.
Se chiamato più volte, l’ultima invocazione ha la precedenza.
Se chiamato da una sottoclasse dell’interfaccia Event, solo i valori specificati nel metodo initEvent vengono modificati, tutti gli altri attributi rimangono invariati.

PreventDefault()

Se un evento è cancellabile, il metodo Aspose.Html.Dom.Events.Event.PreventDefault viene utilizzato per indicare che l’evento deve essere annullato,
significando che qualsiasi azione predefinita normalmente eseguita dall’implementazione a seguito dell’evento non si verificherà.

[DOMName("preventDefault")]
public void PreventDefault()

Osservazioni

Se, durante qualsiasi fase del flusso di eventi, viene chiamato il metodo Aspose.Html.Dom.Events.Event.PreventDefault, l’evento viene annullato.
Qualsiasi azione predefinita associata all’evento non si verificherà.
Chiamare questo metodo per un evento non cancellabile non ha effetto.
Una volta che Aspose.Html.Dom.Events.Event.PreventDefault è stato chiamato, rimarrà in vigore per il resto della propagazione dell’evento.
Questo metodo può essere utilizzato durante qualsiasi fase del flusso di eventi.

StopImmediatePropagation()

Invocare questo metodo impedisce all’evento di raggiungere qualsiasi ascoltatore di eventi registrato dopo quello attuale e, quando viene inviato in un albero, impedisce anche all’evento di raggiungere qualsiasi altro oggetto.

[DOMName("stopImmediatePropagation")]
public void StopImmediatePropagation()

StopPropagation()

Il metodo Aspose.Html.Dom.Events.Event.StopPropagation viene utilizzato per impedire ulteriore propagazione di un evento durante il flusso di eventi.

[DOMName("stopPropagation")]
public void StopPropagation()

Osservazioni

Se questo metodo viene chiamato da qualsiasi Aspose.Html.Dom.Events.IEventListener, l’evento cesserà di propagarsi attraverso l’albero.
L’evento completerà l’invio a tutti gli ascoltatori sull’attuale Aspose.Html.Dom.Events.IEventTarget prima che il flusso di eventi si fermi.
Questo metodo può essere utilizzato durante qualsiasi fase del flusso di eventi.