Class EventTarget

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

L’interfaccia Aspose.Html.Dom.EventTarget è implementata da tutti i nodi in un’implementazione che supporta il modello di eventi DOM.
Pertanto, questa interfaccia può essere ottenuta utilizzando metodi di casting specifici per il binding su un’istanza dell’interfaccia Node.
L’interfaccia consente la registrazione e la rimozione di Event Listener su un Aspose.Html.Dom.EventTarget e la distribuzione di eventi a quel Aspose.Html.Dom.Events.IEventTarget.

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

Ereditarietà

object ←
DOMObject ←
EventTarget

Derivato

MediaQueryList,
Node

Implementa

INotifyPropertyChanged,
IEventTarget,
IDisposable

Membri ereditati

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

Costruttori

EventTarget()

public EventTarget()

Metodi

AddEventListener(string, DOMEventHandler, bool)

Questo metodo consente la registrazione di listener di eventi sul target dell’evento.

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

Parametri

type string

Il tipo di evento per il quale l’utente si sta registrando

handler DOMEventHandler

Accetta un Aspose.Html.Dom.Events.DOMEventHandler da chiamare quando si verifica l’evento.

useCapture bool

Se true, useCapture indica che l’utente desidera avviare la cattura.
Dopo aver avviato la cattura, tutti gli eventi del tipo specificato verranno distribuiti all’Aspose.Html.Dom.Events.IEventListener registrato prima di essere distribuiti a qualsiasi Event Target sottostante nell’albero.
Gli eventi che risalgono l’albero non attiveranno un Aspose.Html.Dom.Events.IEventListener designato per utilizzare la cattura.

Osservazioni

Se un Aspose.Html.Dom.Events.IEventListener viene aggiunto a un Aspose.Html.Dom.EventTarget mentre sta elaborando un evento, non verrà attivato dalle azioni correnti, ma potrebbe essere attivato durante una fase successiva del flusso di eventi, come la fase di bubbling.

Se più listener di eventi identici sono registrati sullo stesso Aspose.Html.Dom.EventTarget con gli stessi parametri, le istanze duplicate vengono scartate. Non causano l'invocazione dell'Aspose.Html.Dom.Events.IEventListener due volte e poiché vengono scartate, non è necessario rimuoverle con il metodo Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean).

AddEventListener(string, IEventListener)

Questo metodo consente la registrazione di listener di eventi sul target dell’evento.

public void AddEventListener(string type, IEventListener listener)

Parametri

type string

Il tipo di evento per il quale l’utente si sta registrando

listener IEventListener

Accetta un’interfaccia implementata dall’utente che contiene i metodi da chiamare quando si verifica l’evento.

Osservazioni

Se un Aspose.Html.Dom.Events.IEventListener viene aggiunto a un Aspose.Html.Dom.EventTarget mentre sta elaborando un evento, non verrà attivato dalle azioni correnti, ma potrebbe essere attivato durante una fase successiva del flusso di eventi, come la fase di bubbling.

Se più listener di eventi identici sono registrati sullo stesso Aspose.Html.Dom.EventTarget con gli stessi parametri, le istanze duplicate vengono scartate. Non causano l'invocazione dell'Aspose.Html.Dom.Events.IEventListener due volte e poiché vengono scartate, non è necessario rimuoverle con il metodo Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean).

AddEventListener(string, IEventListener, bool)

Questo metodo consente la registrazione di listener di eventi sul target dell’evento.

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

Parametri

type string

Il tipo di evento per il quale l’utente si sta registrando

listener IEventListener

Accetta un’interfaccia implementata dall’utente che contiene i metodi da chiamare quando si verifica l’evento.

useCapture bool

Se true, useCapture indica che l’utente desidera avviare la cattura.
Dopo aver avviato la cattura, tutti gli eventi del tipo specificato verranno distribuiti all’Aspose.Html.Dom.Events.IEventListener registrato prima di essere distribuiti a qualsiasi Event Target sottostante nell’albero.
Gli eventi che risalgono l’albero non attiveranno un Aspose.Html.Dom.Events.IEventListener designato per utilizzare la cattura.

Osservazioni

Se un Aspose.Html.Dom.Events.IEventListener viene aggiunto a un Aspose.Html.Dom.EventTarget mentre sta elaborando un evento, non verrà attivato dalle azioni correnti, ma potrebbe essere attivato durante una fase successiva del flusso di eventi, come la fase di bubbling.

Se più listener di eventi identici sono registrati sullo stesso Aspose.Html.Dom.EventTarget con gli stessi parametri, le istanze duplicate vengono scartate. Non causano l'invocazione dell'Aspose.Html.Dom.Events.IEventListener due volte e poiché vengono scartate, non è necessario rimuoverle con il metodo Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean).

DispatchEvent(Event)

Questo metodo consente la distribuzione di eventi nel modello di eventi delle implementazioni.

public bool DispatchEvent(Event @event)

Parametri

event Event

Specifica il tipo di evento, il comportamento e le informazioni contestuali da utilizzare nell’elaborazione dell’evento.

Restituisce

bool

Il valore di ritorno di Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) indica se uno dei listener che ha gestito l’evento ha chiamato Aspose.Html.Dom.Events.Event.PreventDefault.
Se Aspose.Html.Dom.Events.Event.PreventDefault è stato chiamato, il valore è false, altrimenti il valore è true.

Osservazioni

Gli eventi distribuiti in questo modo avranno lo stesso comportamento di cattura e bubbling degli eventi distribuiti direttamente dall’implementazione.
Il target dell’evento è l’Aspose.Html.Dom.EventTarget su cui viene chiamato Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event).

Eccezioni

DOMException

Dispose()

Esegue attività definite dall’applicazione associate al rilascio, alla liberazione o al ripristino delle risorse non gestite.

public void Dispose()

Dispose(bool)

Rilascia risorse non gestite e - facoltativamente - gestite.

protected virtual void Dispose(bool disposing)

Parametri

disposing bool

true per rilasciare sia risorse gestite che non gestite; false per rilasciare solo risorse non gestite.

RemoveEventListener(string, DOMEventHandler, bool)

Questo metodo consente la rimozione di listener di eventi dal target dell’evento.
Se un Aspose.Html.Dom.Events.IEventListener viene rimosso da un Aspose.Html.Dom.EventTarget mentre sta elaborando un evento, non verrà attivato dalle azioni correnti.
I listener di eventi non possono mai essere invocati dopo essere stati rimossi.

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

Parametri

type string

Specifica il tipo di evento dell’Aspose.Html.Dom.Events.IEventListener che viene rimosso.

handler DOMEventHandler

Il parametro Aspose.Html.Dom.Events.DOMEventHandler indica l’Aspose.Html.Dom.Events.IEventListener da rimuovere.

useCapture bool

Specifica se l’EventListener che viene rimosso è stato registrato come listener di cattura o meno.
Se un listener è stato registrato due volte, una con cattura e una senza, ciascuno deve essere rimosso separatamente.
La rimozione di un listener di cattura non influisce su una versione non catturante dello stesso listener, e viceversa.

RemoveEventListener(string, IEventListener)

Questo metodo consente la rimozione di listener di eventi dal target dell’evento.
Se un Aspose.Html.Dom.Events.IEventListener viene rimosso da un Aspose.Html.Dom.EventTarget mentre sta elaborando un evento, non verrà attivato dalle azioni correnti.
I listener di eventi non possono mai essere invocati dopo essere stati rimossi.

public void RemoveEventListener(string type, IEventListener listener)

Parametri

type string

Specifica il tipo di evento dell’Aspose.Html.Dom.Events.IEventListener che viene rimosso.

listener IEventListener

Il parametro Aspose.Html.Dom.Events.IEventListener indica l’Aspose.Html.Dom.Events.IEventListener da rimuovere.

RemoveEventListener(string, IEventListener, bool)

Questo metodo consente la rimozione di listener di eventi dal target dell’evento.
Se un Aspose.Html.Dom.Events.IEventListener viene rimosso da un Aspose.Html.Dom.EventTarget mentre sta elaborando un evento, non verrà attivato dalle azioni correnti.
I listener di eventi non possono mai essere invocati dopo essere stati rimossi.

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

Parametri

type string

Specifica il tipo di evento dell’Aspose.Html.Dom.Events.IEventListener che viene rimosso.

listener IEventListener

Il parametro Aspose.Html.Dom.Events.IEventListener indica l’Aspose.Html.Dom.Events.IEventListener da rimuovere.

useCapture bool

Specifica se l’EventListener che viene rimosso è stato registrato come listener di cattura o meno.
Se un listener è stato registrato due volte, una con cattura e una senza, ciascuno deve essere rimosso separatamente.
La rimozione di un listener di cattura non influisce su una versione non catturante dello stesso listener, e viceversa.