Interface IEventTarget

Namespace: Aspose.Html.Dom.Events
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 el registro y la 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)]
[DOMNoInterfaceObject]
public interface IEventTarget

Métodos

AddEventListener(string, IEventListener)

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

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

Parámetros

type string

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

listener IEventListener

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

Notas

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

Si se registran múltiples escuchadores de eventos idénticos en el mismo Aspose.Html.Dom.EventTarget con los mismos parámetros, las instancias duplicadas son descartadas. No causan que el Aspose.Html.Dom.Events.IEventListener sea llamado dos veces y, dado que son descartadas, no necesitan ser eliminadas con el método Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).

AddEventListener(string, IEventListener, bool)

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

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

Toma 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 serán distribuidos al Aspose.Html.Dom.Events.IEventListener registrado
antes de ser distribuidos a cualquier objetivo de evento 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.

Notas

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

Si se registran múltiples escuchadores de eventos idénticos en el mismo Aspose.Html.Dom.EventTarget con los mismos parámetros, las instancias duplicadas son descartadas. No causan que el Aspose.Html.Dom.Events.IEventListener sea llamado dos veces y, dado que son descartadas, no necesitan ser eliminadas con el método Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).

DispatchEvent(Event)

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

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

Notas

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

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 es eliminado de un Aspose.Html.Dom.EventTarget mientras está procesando un evento, no se activará por las acciones actuales.
Los escuchadores de eventos nunca pueden ser invocados después de ser eliminados.

[DOMName("removeEventListener")]
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 es eliminado de un Aspose.Html.Dom.EventTarget mientras está procesando un evento, no se activará por las acciones actuales.
Los escuchadores de eventos nunca pueden ser invocados después de ser eliminados.

[DOMName("removeEventListener")]
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 oyente de captura o no.
Si un oyente fue registrado dos veces, uno con captura y otro sin, cada uno debe ser eliminado por separado.
La eliminación de un oyente de captura no afecta a una versión no capturadora del mismo oyente, y viceversa.