Class EventTarget

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

La interfaz Aspose.Html.Dom.EventTarget es implementada por todos los nodos en una implementación que soporta el modelo de eventos DOM.
Por lo tanto, esta interfaz se puede obtener utilizando métodos de conversión específicos de enlace en una instancia de la interfaz Node.
La interfaz permite la registro y eliminación de escuchadores de eventos en un Aspose.Html.Dom.EventTarget y la distribución de eventos a ese Aspose.Html.Dom.Events.IEventTarget.

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

Herencia

object ←
DOMObject ←
EventTarget

Derivados

MediaQueryList,
Node

Implementa

INotifyPropertyChanged,
IEventTarget,
IDisposable

Miembros heredados

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

Constructores

EventTarget()

public EventTarget()

Métodos

AddEventListener(string, DOMEventHandler, bool)

Este método permite el registro de escuchadores de eventos en el objetivo del evento.

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

Parámetros

type string

El tipo de evento para el cual el usuario se está registrando.

handler DOMEventHandler

Recibe un Aspose.Html.Dom.Events.DOMEventHandler que se llamará cuando ocurra el evento.

useCapture bool

Si es verdadero, useCapture indica que el usuario desea iniciar la captura.
Después de iniciar la captura, todos los eventos del tipo especificado se enviarán al Aspose.Html.Dom.Events.IEventListener registrado antes de ser enviados a cualquier objetivo de evento por debajo de ellos en el árbol.
Los eventos que están burbujeando hacia arriba a través del árbol no activarán un Aspose.Html.Dom.Events.IEventListener designado para usar captura.

Observaciones

Si un Aspose.Html.Dom.Events.IEventListener se agrega a un Aspose.Html.Dom.EventTarget mientras se está procesando un evento, no será activado por las acciones actuales, pero puede ser activado durante una etapa posterior del flujo de eventos, como la fase de burbujeo.

Si múltiples escuchadores de eventos idénticos están registrados en el mismo Aspose.Html.Dom.EventTarget con los mismos parámetros, las instancias duplicadas se descartan. No causan que el Aspose.Html.Dom.Events.IEventListener se llame dos veces y, dado que se descartan, no necesitan ser eliminadas con el método Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean).

AddEventListener(string, IEventListener)

Este método permite el registro de escuchadores de eventos en el objetivo del evento.

public void AddEventListener(string type, IEventListener listener)

Parámetros

type string

El tipo de evento para el cual el usuario se está registrando.

listener IEventListener

Recibe una interfaz implementada por el usuario que contiene los métodos que se llamarán cuando ocurra el evento.

Observaciones

Si un Aspose.Html.Dom.Events.IEventListener se agrega a un Aspose.Html.Dom.EventTarget mientras se está procesando un evento, no será activado por las acciones actuales, pero puede ser activado durante una etapa posterior del flujo de eventos, como la fase de burbujeo.

Si múltiples escuchadores de eventos idénticos están registrados en el mismo Aspose.Html.Dom.EventTarget con los mismos parámetros, las instancias duplicadas se descartan. No causan que el Aspose.Html.Dom.Events.IEventListener se llame dos veces y, dado que se descartan, no necesitan ser eliminadas con el método Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean).

AddEventListener(string, IEventListener, bool)

Este método permite el registro de escuchadores de eventos en el objetivo del evento.

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

Parámetros

type string

El tipo de evento para el cual el usuario se está registrando.

listener IEventListener

Recibe una interfaz implementada por el usuario que contiene los métodos que se llamarán cuando ocurra el evento.

useCapture bool

Si es verdadero, useCapture indica que el usuario desea iniciar la captura.
Después de iniciar la captura, todos los eventos del tipo especificado se enviarán al Aspose.Html.Dom.Events.IEventListener registrado antes de ser enviados a cualquier objetivo de evento por debajo de ellos en el árbol.
Los eventos que están burbujeando hacia arriba a través del árbol no activarán un Aspose.Html.Dom.Events.IEventListener designado para usar captura.

Observaciones

Si un Aspose.Html.Dom.Events.IEventListener se agrega a un Aspose.Html.Dom.EventTarget mientras se está procesando un evento, no será activado por las acciones actuales, pero puede ser activado durante una etapa posterior del flujo de eventos, como la fase de burbujeo.

Si múltiples escuchadores de eventos idénticos están registrados en el mismo Aspose.Html.Dom.EventTarget con los mismos parámetros, las instancias duplicadas se descartan. No causan que el Aspose.Html.Dom.Events.IEventListener se llame dos veces y, dado que se descartan, no necesitan ser eliminadas con el método Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean).

DispatchEvent(Event)

Este método permite la distribución de eventos en el modelo de eventos de la implementación.

public bool DispatchEvent(Event @event)

Parámetros

event Event

Especifica el tipo de evento, comportamiento e información contextual que se utilizará en el procesamiento del evento.

Retorna

bool

El valor de retorno de Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) indica si alguno de los escuchadores que manejaron el evento llamó a Aspose.Html.Dom.Events.Event.PreventDefault.
Si se llamó a Aspose.Html.Dom.Events.Event.PreventDefault, el valor es falso; de lo contrario, el valor es verdadero.

Observaciones

Los eventos distribuidos de esta manera tendrán el mismo comportamiento de captura y burbujeo que los eventos distribuidos directamente por la implementación.
El objetivo del evento es el Aspose.Html.Dom.EventTarget sobre el cual se llama a Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event).

Excepciones

DOMException

Dispose()

Realiza tareas definidas por la aplicación relacionadas con la liberación, liberación o reinicio de recursos no gestionados.

public void Dispose()

Dispose(bool)

Libera recursos no gestionados y, opcionalmente, recursos gestionados.

protected virtual void Dispose(bool disposing)

Parámetros

disposing bool

true para liberar tanto recursos gestionados como no gestionados; false para liberar solo recursos no gestionados.

RemoveEventListener(string, DOMEventHandler, bool)

Este método permite la eliminación de escuchadores de eventos del objetivo del evento.
Si un Aspose.Html.Dom.Events.IEventListener se elimina de un Aspose.Html.Dom.EventTarget mientras se está procesando un evento, no será activado por las acciones actuales.
Los escuchadores de eventos nunca pueden ser invocados después de ser eliminados.

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

Parámetros

type string

Especifica el tipo de evento del Aspose.Html.Dom.Events.IEventListener que se está eliminando.

handler DOMEventHandler

El parámetro Aspose.Html.Dom.Events.DOMEventHandler indica el Aspose.Html.Dom.Events.IEventListener que se va a eliminar.

useCapture bool

Especifica si el EventListener que se está eliminando fue registrado como un escuchador de captura o no.
Si un escuchador fue registrado dos veces, una con captura y otra sin, cada uno debe ser eliminado por separado.
La eliminación de un escuchador de captura no afecta a una versión no capturadora del mismo escuchador, y viceversa.

RemoveEventListener(string, IEventListener)

Este método permite la eliminación de escuchadores de eventos del objetivo del evento.
Si un Aspose.Html.Dom.Events.IEventListener se elimina de un Aspose.Html.Dom.EventTarget mientras se está procesando un evento, no será activado por las acciones actuales.
Los escuchadores de eventos nunca pueden ser invocados después de ser eliminados.

public void RemoveEventListener(string type, IEventListener listener)

Parámetros

type string

Especifica el tipo de evento del Aspose.Html.Dom.Events.IEventListener que se está eliminando.

listener IEventListener

El parámetro Aspose.Html.Dom.Events.IEventListener indica el Aspose.Html.Dom.Events.IEventListener que se va a eliminar.

RemoveEventListener(string, IEventListener, bool)

Este método permite la eliminación de escuchadores de eventos del objetivo del evento.
Si un Aspose.Html.Dom.Events.IEventListener se elimina de un Aspose.Html.Dom.EventTarget mientras se está procesando un evento, no será activado por las acciones actuales.
Los escuchadores de eventos nunca pueden ser invocados después de ser eliminados.

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

Parámetros

type string

Especifica el tipo de evento del Aspose.Html.Dom.Events.IEventListener que se está eliminando.

listener IEventListener

El parámetro Aspose.Html.Dom.Events.IEventListener indica el Aspose.Html.Dom.Events.IEventListener que se va a eliminar.

useCapture bool

Especifica si el EventListener que se está eliminando fue registrado como un escuchador de captura o no.
Si un escuchador fue registrado dos veces, una con captura y una sin, cada uno debe ser eliminado por separado.
La eliminación de un escuchador de captura no afecta a una versión no capturadora del mismo escuchador, y viceversa.