Class EventTarget

Namespace: Aspose.Html.Dom
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 a distribuição de eventos para esse Aspose.Html.Dom.Events.IEventTarget.

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

Herança

object ←
DOMObject ←
EventTarget

Derivados

MediaQueryList,
Node

Implementa

INotifyPropertyChanged,
IEventTarget,
IDisposable

Membros Herdados

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

Construtores

EventTarget()

public EventTarget()

Métodos

AddEventListener(string, DOMEventHandler, bool)

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

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

Parâmetros

type string

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

handler DOMEventHandler

Recebe um Aspose.Html.Dom.Events.DOMEventHandler a ser chamado 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 enviados ao Aspose.Html.Dom.Events.IEventListener registrado antes de serem enviados a 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 estiver processando um evento, ele não será acionado pelas ações atuais, mas pode ser acionado durante uma fase posterior do fluxo de eventos, como a fase de bolhas.

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

AddEventListener(string, IEventListener)

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

public 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 estiver processando um evento, ele não será acionado pelas ações atuais, mas pode ser acionado durante uma fase posterior do fluxo de eventos, como a fase de bolhas.

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

AddEventListener(string, IEventListener, bool)

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

public 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 enviados ao Aspose.Html.Dom.Events.IEventListener registrado antes de serem enviados a 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 estiver processando um evento, ele não será acionado pelas ações atuais, mas pode ser acionado durante uma fase posterior do fluxo de eventos, como a fase de bolhas.

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

DispatchEvent(Event)

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

public 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 distribuídos dessa maneira terão o mesmo comportamento de captura e bolhas que eventos distribuídos 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

Dispose()

Executa tarefas definidas pelo aplicativo associadas à liberação, liberação ou redefinição de recursos não gerenciados.

public void Dispose()

Dispose(bool)

Libera recursos não gerenciados e - opcionalmente - recursos gerenciados.

protected virtual void Dispose(bool disposing)

Parâmetros

disposing bool

true para liberar tanto recursos gerenciados quanto não gerenciados; false para liberar apenas recursos não gerenciados.

RemoveEventListener(string, DOMEventHandler, bool)

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

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

Parâmetros

type string

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

handler DOMEventHandler

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

useCapture bool

Especifica se o EventListener 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 capturante do mesmo ouvinte, e vice-versa.

RemoveEventListener(string, IEventListener)

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

public void RemoveEventListener(string type, IEventListener listener)

Parâmetros

type string

Especifica o tipo de evento do Aspose.Html.Dom.Events.IEventListener 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 do evento.
Se um Aspose.Html.Dom.Events.IEventListener for removido de um Aspose.Html.Dom.EventTarget enquanto ele estiver processando um evento, ele não será acionado pelas ações atuais.
Event Listeners nunca podem ser invocados após serem removidos.

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

Parâmetros

type string

Especifica o tipo de evento do Aspose.Html.Dom.Events.IEventListener 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 sendo removido foi registrado como um ouvinte de captura ou não.
Se um ouvinte foi registrado duas vezes, uma com captura e uma sem, cada um deve ser removido separadamente.
A remoção de um ouvinte de captura não afeta uma versão não capturante do mesmo ouvinte, e vice-versa.