Class Event
Namespace: Aspose.Html.Dom.Events
Assembly: Aspose.HTML.dll (25.1.0)
La Aspose.Html.Dom.Events.Event se utiliza para proporcionar información contextual sobre un evento al manejador que procesa el evento.
[ComVisible(true)]
[DOMObject]
[DOMName("Event")]
public class Event : DOMObject, INotifyPropertyChanged
Herencia
Derivados
CustomEvent, ErrorEvent, SVGZoomEvent, TimeEvent, UIEvent
Implementa
Miembros heredados
DOMObject.GetPlatformType(), object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Observaciones
Un objeto que implementa la Aspose.Html.Dom.Events.Event generalmente se pasa como el primer parámetro a un manejador de eventos.
Información de contexto más específica se pasa a los manejadores de eventos mediante la derivación de interfaces adicionales de Aspose.Html.Dom.Events.Event
que contienen información directamente relacionada con el tipo de evento que acompañan.
Estas interfaces derivadas también son implementadas por el objeto pasado al oyente de eventos.
Constructores
Event(string)
Inicializa una nueva instancia de la clase Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type)
Parámetros
type
string
El tipo de evento.
Event(string, IDictionary<string, object="">)
Inicializa una nueva instancia de la clase Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type, IDictionary<string, object=""> eventInitDict)
Parámetros
type
string
El tipo de evento.
eventInitDict
IDictionary<string, object>
El diccionario de inicialización del evento.
Campos
AtTargetPhase
La fase actual del evento es la fase de captura.
[DOMName("AT_TARGET")]
public const ushort AtTargetPhase = 2
Valor del campo
BubblingPhase
La fase actual del evento es la fase de burbujeo.
[DOMName("BUBBLING_PHASE")]
public const ushort BubblingPhase = 3
Valor del campo
CapturingPhase
El evento se está evaluando actualmente en el Aspose.Html.Dom.Events.IEventTarget objetivo.
[DOMName("CAPTURING_PHASE")]
public const ushort CapturingPhase = 1
Valor del campo
NonePhase
Los eventos que no se están despachando actualmente están en esta fase.
[DOMName("NONE")]
public const ushort NonePhase = 0
Valor del campo
Propiedades
Bubbles
Se utiliza para indicar si un evento es un evento de burbujeo o no. Si el evento puede burbujear, el valor es verdadero; de lo contrario, el valor es falso.
[DOMName("bubbles")]
public bool Bubbles { get; }
Valor de la propiedad
Cancelable
Se utiliza para indicar si se puede prevenir la acción predeterminada de un evento. Si la acción predeterminada se puede prevenir, el valor es verdadero; de lo contrario, el valor es falso.
[DOMName("cancelable")]
public bool Cancelable { get; }
Valor de la propiedad
CurrentTarget
Se utiliza para indicar el Aspose.Html.Dom.Events.IEventTarget cuyas Aspose.Html.Dom.Events.IEventListeners se están procesando actualmente.
Esto es particularmente útil durante la captura y la burbujeo.
[DOMName("currentTarget")]
[DOMNullable]
public EventTarget CurrentTarget { get; }
Valor de la propiedad
DefaultPrevented
Devuelve verdadero si se invocó preventDefault() mientras el valor del atributo cancelable es verdadero, y falso en caso contrario.
[DOMName("defaultPrevented")]
public bool DefaultPrevented { get; }
Valor de la propiedad
EventPhase
Se utiliza para indicar qué fase del flujo de eventos se está evaluando actualmente.
[DOMName("eventPhase")]
public ushort EventPhase { get; }
Valor de la propiedad
IsTrusted
El atributo isTrusted debe devolver el valor con el que se inicializó. Cuando se crea un evento, el atributo debe inicializarse en falso.
[DOMName("isTrusted")]
public bool IsTrusted { get; }
Valor de la propiedad
Target
Se utiliza para indicar el Aspose.Html.Dom.Events.IEventTarget al que se despachó originalmente el evento.
[DOMNullable]
[DOMName("target")]
public EventTarget Target { get; }
Valor de la propiedad
TimeStamp
Se utiliza para especificar el tiempo (en milisegundos relativo a la época) en el que se creó el evento.
Debido a que algunos sistemas pueden no proporcionar esta información, el valor de timeStamp puede no estar disponible para todos los eventos.
Cuando no está disponible, se devolverá un valor de 0.
Ejemplos de tiempo de época son el tiempo de inicio del sistema o 0:0:0 UTC 1 de enero de 1970.
[DOMName("timeStamp")]
public ulong TimeStamp { get; }
Valor de la propiedad
Type
El nombre del evento (sin distinción entre mayúsculas y minúsculas). El nombre debe ser un nombre XML.
[DOMName("type")]
public string Type { get; }
Valor de la propiedad
Métodos
InitEvent(string, bool, bool)
El método Aspose.Html.Dom.Events.Event.InitEvent(System.String,System.Boolean,System.Boolean) se utiliza para inicializar el valor de un Aspose.Html.Dom.Events.Event creado a través de la
interfaz Aspose.Html.Dom.Events.IDocumentEvent.
[DOMName("initEvent")]
public void InitEvent(string type, bool bubbles, bool cancelable)
Parámetros
type
string
El tipo de evento.
bubbles
bool
si se establece en true
[bubbles].
cancelable
bool
si se establece en true
[cancelable].
Observaciones
Este método solo puede ser llamado antes de que el evento haya sido despachado a través del método Aspose.Html.Dom.Events.IEventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event),
aunque puede ser llamado múltiples veces durante esa fase si es necesario.
Si se llama múltiples veces, la última invocación tiene prioridad.
Si se llama desde una subclase de la interfaz Event, solo se modifican los valores especificados en el método initEvent; todos los demás atributos permanecen sin cambios.
PreventDefault()
Si un evento es cancelable, el método Aspose.Html.Dom.Events.Event.PreventDefault se utiliza para significar que el evento debe ser cancelado,
lo que significa que cualquier acción predeterminada normalmente realizada por la implementación como resultado del evento no ocurrirá.
[DOMName("preventDefault")]
public void PreventDefault()
Observaciones
Si, durante cualquier etapa del flujo de eventos, se llama al método Aspose.Html.Dom.Events.Event.PreventDefault, el evento se cancela.
Cualquier acción predeterminada asociada con el evento no ocurrirá.
Llamar a este método para un evento no cancelable no tiene efecto.
Una vez que se ha llamado a Aspose.Html.Dom.Events.Event.PreventDefault, permanecerá en efecto durante el resto de la propagación del evento.
Este método se puede usar durante cualquier etapa del flujo de eventos.
StopImmediatePropagation()
Invocar este método impide que el evento llegue a cualquier oyente de eventos registrados después del actual y, cuando se despacha en un árbol, también impide que el evento llegue a otros objetos.
[DOMName("stopImmediatePropagation")]
public void StopImmediatePropagation()
StopPropagation()
El método Aspose.Html.Dom.Events.Event.StopPropagation se utiliza para prevenir la propagación adicional de un evento durante el flujo de eventos.
[DOMName("stopPropagation")]
public void StopPropagation()
Observaciones
Si este método es llamado por cualquier Aspose.Html.Dom.Events.IEventListener, el evento dejará de propagarse a través del árbol.
El evento completará el despacho a todos los oyentes en el Aspose.Html.Dom.Events.IEventTarget actual antes de que se detenga el flujo del evento.
Este método se puede usar durante cualquier etapa del flujo de eventos.