Interface IEventTarget

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

A interface Aspose.Html.Dom.EventTarget é implementada por todos os Nós em uma implementação que suporta o Modelo de Evento DOM.
Portanto, essa interface pode ser obtida usando métodos de conversão específicos de binding em uma instância da interface Node.
A interface permite o registro e a remoção de Event Listeners em um Aspose.Html.Dom.EventTarget e o despacho de eventos para esse Aspose.Html.Dom.Events.IEventTarget.

[ComVisible(true)]
[DOMNoInterfaceObject]
public interface IEventTarget

Métodos

AddEventListener(string, IEventListener)

Este método permite o registro de ouvintes de eventos no alvo de evento.

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

Parâmetros

type string

O tipo de evento para o qual o usuário está se registrando

listener IEventListener

Recebe uma interface implementada pelo usuário que contém os métodos a serem chamados quando o evento ocorre.

Observações

Se um Aspose.Html.Dom.Events.IEventListener for adicionado a um Aspose.Html.Dom.EventTarget enquanto ele está processando um evento, não será acionado pelas ações atuais, mas pode ser acionado durante uma fase posterior do fluxo de eventos, como a fase de bolha.

Se múltiplos Event Listeners idênticos forem registrados no mesmo Aspose.Html.Dom.EventTarget com os mesmos parâmetros, as instâncias duplicadas serão descartadas. Elas não fazem com que o Aspose.Html.Dom.Events.IEventListener seja chamado duas vezes e, como são descartadas, não precisam ser removidas com o método Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).

AddEventListener(string, IEventListener, bool)

Este método permite o registro de ouvintes de eventos no alvo de evento.

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

Parâmetros

type string

O tipo de evento para o qual o usuário está se registrando

listener IEventListener

Recebe uma interface implementada pelo usuário que contém os métodos a serem chamados quando o evento ocorre.

useCapture bool

Se verdadeiro, useCapture indica que o usuário deseja iniciar a captura.
Após iniciar a captura, todos os eventos do tipo especificado serão despachados para o Aspose.Html.Dom.Events.IEventListener registrado
antes de serem despachados para qualquer Event Targets abaixo deles na árvore.
Eventos que estão subindo pela árvore não acionarão um Aspose.Html.Dom.Events.IEventListener designado para usar captura.

Observações

Se um Aspose.Html.Dom.Events.IEventListener for adicionado a um Aspose.Html.Dom.EventTarget enquanto ele está processando um evento, não será acionado pelas ações atuais, mas pode ser acionado durante uma fase posterior do fluxo de eventos, como a fase de bolha.

Se múltiplos Event Listeners idênticos forem registrados no mesmo Aspose.Html.Dom.EventTarget com os mesmos parâmetros, as instâncias duplicadas serão descartadas. Elas não fazem com que o Aspose.Html.Dom.Events.IEventListener seja chamado duas vezes e, como são descartadas, não precisam ser removidas com o método Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).

DispatchEvent(Event)

Este método permite o despacho de eventos no modelo de evento das implementações.

[DOMName("dispatchEvent")]
bool DispatchEvent(Event @event)

Parâmetros

event Event

Especifica o tipo de evento, comportamento e informações contextuais a serem usadas no processamento do evento.

Retorna

bool

O valor de retorno de Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) indica se algum dos ouvintes que tratou o evento chamou Aspose.Html.Dom.Events.Event.PreventDefault.
Se Aspose.Html.Dom.Events.Event.PreventDefault foi chamado, o valor é falso; caso contrário, o valor é verdadeiro.

Observações

Eventos despachados dessa maneira terão o mesmo comportamento de captura e bolha que eventos despachados diretamente pela implementação.
O alvo do evento é o Aspose.Html.Dom.EventTarget no qual Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) é chamado.

Exceções

DOMException

RemoveEventListener(string, IEventListener)

Este método permite a remoção de ouvintes de eventos do alvo de evento.
Se um Aspose.Html.Dom.Events.IEventListener for removido de um Aspose.Html.Dom.EventTarget enquanto ele está processando um evento, não será acionado pelas ações atuais.
Event Listeners nunca podem ser invocados após serem removidos.

[DOMName("removeEventListener")]
void RemoveEventListener(string type, IEventListener listener)

Parâmetros

type string

Especifica o tipo de evento do Aspose.Html.Dom.Events.IEventListener que está sendo removido.

listener IEventListener

O parâmetro Aspose.Html.Dom.Events.IEventListener indica o Aspose.Html.Dom.Events.IEventListener a ser removido.

RemoveEventListener(string, IEventListener, bool)

Este método permite a remoção de ouvintes de eventos do alvo de evento.
Se um Aspose.Html.Dom.Events.IEventListener for removido de um Aspose.Html.Dom.EventTarget enquanto ele está processando um evento, não será acionado pelas ações atuais.
Event Listeners nunca podem ser invocados após serem removidos.

[DOMName("removeEventListener")]
void RemoveEventListener(string type, IEventListener listener, bool useCapture)

Parâmetros

type string

Especifica o tipo de evento do Aspose.Html.Dom.Events.IEventListener que está sendo removido.

listener IEventListener

O parâmetro Aspose.Html.Dom.Events.IEventListener indica o Aspose.Html.Dom.Events.IEventListener a ser removido.

useCapture bool

Especifica se o EventListener que está sendo removido foi registrado como um ouvinte de captura ou não.
Se um ouvinte foi registrado duas vezes, uma com captura e outra sem, cada um deve ser removido separadamente.
A remoção de um ouvinte de captura não afeta uma versão não capturada do mesmo ouvinte, e vice-versa.