Interface IEventTarget
Namespace: Aspose.Html.Dom.Events
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 Listeners su un Aspose.Html.Dom.EventTarget e l’invio di eventi a quel Aspose.Html.Dom.Events.IEventTarget.
[ComVisible(true)]
[DOMNoInterfaceObject]
public interface IEventTargetMetodi
AddEventListener(string, IEventListener)
Questo metodo consente la registrazione di listener di eventi sull’oggetto evento.
[DOMName("addEventListener")]
void AddEventListener(string type, IEventListener listener)Parametri
type string
Il tipo di evento per il quale l’utente si sta registrando
listener IEventListener
Prende 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 degli eventi, come la fase di bubbling.
Se più Event Listeners identici sono registrati sullo stesso Aspose.Html.Dom.EventTarget con gli stessi parametri, le istanze duplicate vengono scartate. Non causano la chiamata dell'Aspose.Html.Dom.Events.IEventListener due volte e, poiché vengono scartate, non è necessario rimuoverle con il metodo Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).
AddEventListener(string, IEventListener, bool)
Questo metodo consente la registrazione di listener di eventi sull’oggetto evento.
[DOMName("addEventListener")]
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
Prende 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 inviati all’Aspose.Html.Dom.Events.IEventListener registrato
prima di essere inviati a qualsiasi Event Target sottostante nell’albero.
Gli eventi che stanno risalendo nell’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 degli eventi, come la fase di bubbling.
Se più Event Listeners identici sono registrati sullo stesso Aspose.Html.Dom.EventTarget con gli stessi parametri, le istanze duplicate vengono scartate. Non causano la chiamata dell'Aspose.Html.Dom.Events.IEventListener due volte e, poiché vengono scartate, non è necessario rimuoverle con il metodo Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).
DispatchEvent(Event)
Questo metodo consente l’invio di eventi nel modello di eventi dell’implementazione.
[DOMName("dispatchEvent")]
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
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 inviati in questo modo avranno lo stesso comportamento di cattura e bubbling degli eventi inviati direttamente dall’implementazione.
L’obiettivo dell’evento è l’Aspose.Html.Dom.EventTarget su cui viene chiamato Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event).
Eccezioni
RemoveEventListener(string, IEventListener)
Questo metodo consente la rimozione di listener di eventi dall’oggetto 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.
[DOMName("removeEventListener")]
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 dall’oggetto 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.
[DOMName("removeEventListener")]
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 il listener di eventi 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.
