Interface IEventTarget

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

Interfejs Aspose.Html.Dom.EventTarget jest implementowany przez wszystkie węzły w implementacji, która wspiera model zdarzeń DOM.
Dlatego ten interfejs można uzyskać, używając specyficznych dla wiązania metod rzutowania na instancji interfejsu Node.
Interfejs ten pozwala na rejestrację i usuwanie nasłuchiwaczy zdarzeń na Aspose.Html.Dom.EventTarget oraz na wysyłanie zdarzeń do tego Aspose.Html.Dom.Events.IEventTarget.

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

Metody

AddEventListener(string, IEventListener)

Ta metoda pozwala na rejestrację nasłuchiwaczy zdarzeń na obiekcie docelowym zdarzenia.

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

Parametry

type string

Typ zdarzenia, dla którego użytkownik rejestruje

listener IEventListener

Interfejs implementowany przez użytkownika, który zawiera metody, które mają być wywoływane, gdy zdarzenie wystąpi.

Uwagi

Jeśli Aspose.Html.Dom.Events.IEventListener zostanie dodany do Aspose.Html.Dom.EventTarget podczas przetwarzania zdarzenia, nie zostanie wywołany przez bieżące działania, ale może zostać wywołany na późniejszym etapie przepływu zdarzeń, takim jak faza bąbelkowania.

Jeśli wiele identycznych nasłuchiwaczy zdarzeń jest rejestrowanych na tym samym Aspose.Html.Dom.EventTarget z tymi samymi parametrami, duplikaty są odrzucane. Nie powodują one wywołania Aspose.Html.Dom.Events.IEventListener dwa razy, a ponieważ są odrzucane, nie muszą być usuwane za pomocą metody Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).

AddEventListener(string, IEventListener, bool)

Ta metoda pozwala na rejestrację nasłuchiwaczy zdarzeń na obiekcie docelowym zdarzenia.

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

Parametry

type string

Typ zdarzenia, dla którego użytkownik rejestruje

listener IEventListener

Interfejs implementowany przez użytkownika, który zawiera metody, które mają być wywoływane, gdy zdarzenie wystąpi.

useCapture bool

Jeśli true, useCapture wskazuje, że użytkownik chce zainicjować przechwytywanie.
Po zainicjowaniu przechwytywania, wszystkie zdarzenia określonego typu będą wysyłane do zarejestrowanego
Aspose.Html.Dom.Events.IEventListener
zanim zostaną wysłane do jakichkolwiek obiektów docelowych zdarzeń poniżej nich w drzewie.
Zdarzenia, które bąbelkują w górę przez drzewo, nie wywołają Aspose.Html.Dom.Events.IEventListener oznaczonego do użycia przechwytywania.

Uwagi

Jeśli Aspose.Html.Dom.Events.IEventListener zostanie dodany do Aspose.Html.Dom.EventTarget podczas przetwarzania zdarzenia, nie zostanie wywołany przez bieżące działania, ale może zostać wywołany na późniejszym etapie przepływu zdarzeń, takim jak faza bąbelkowania.

Jeśli wiele identycznych nasłuchiwaczy zdarzeń jest rejestrowanych na tym samym Aspose.Html.Dom.EventTarget z tymi samymi parametrami, duplikaty są odrzucane. Nie powodują one wywołania Aspose.Html.Dom.Events.IEventListener dwa razy, a ponieważ są odrzucane, nie muszą być usuwane za pomocą metody Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).

DispatchEvent(Event)

Ta metoda pozwala na wysyłanie zdarzeń do modelu zdarzeń implementacji.

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

Parametry

event Event

Określa typ zdarzenia, zachowanie i informacje kontekstowe, które mają być używane w przetwarzaniu zdarzenia.

Zwraca

bool

Wartość zwracana przez Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) wskazuje, czy którykolwiek z nasłuchiwaczy, którzy obsłużyli zdarzenie, wywołał Aspose.Html.Dom.Events.Event.PreventDefault.
Jeśli Aspose.Html.Dom.Events.Event.PreventDefault został wywołany, wartość to false, w przeciwnym razie wartość to true.

Uwagi

Zdarzenia wysyłane w ten sposób będą miały takie same zachowanie przechwytywania i bąbelkowania, jak zdarzenia wysyłane bezpośrednio przez implementację.
Obiektem docelowym zdarzenia jest Aspose.Html.Dom.EventTarget, na którym wywoływana jest Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event).

Wyjątki

DOMException

RemoveEventListener(string, IEventListener)

Ta metoda pozwala na usunięcie nasłuchiwaczy zdarzeń z obiektu docelowego zdarzenia.
Jeśli Aspose.Html.Dom.Events.IEventListener zostanie usunięty z Aspose.Html.Dom.EventTarget podczas przetwarzania zdarzenia, nie zostanie wywołany przez bieżące działania.
Nasłuchiwacze zdarzeń nigdy nie mogą być wywołani po ich usunięciu.

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

Parametry

type string

Określa typ zdarzenia Aspose.Html.Dom.Events.IEventListener, który ma być usunięty.

listener IEventListener

Parametr Aspose.Html.Dom.Events.IEventListener wskazuje na Aspose.Html.Dom.Events.IEventListener, który ma być usunięty.

RemoveEventListener(string, IEventListener, bool)

Ta metoda pozwala na usunięcie nasłuchiwaczy zdarzeń z obiektu docelowego zdarzenia.
Jeśli Aspose.Html.Dom.Events.IEventListener zostanie usunięty z Aspose.Html.Dom.EventTarget podczas przetwarzania zdarzenia, nie zostanie wywołany przez bieżące działania.
Nasłuchiwacze zdarzeń nigdy nie mogą być wywołani po ich usunięciu.

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

Parametry

type string

Określa typ zdarzenia Aspose.Html.Dom.Events.IEventListener, który ma być usunięty.

listener IEventListener

Parametr Aspose.Html.Dom.Events.IEventListener wskazuje na Aspose.Html.Dom.Events.IEventListener, który ma być usunięty.

useCapture bool

Określa, czy nasłuchiwacz zdarzeń, który jest usuwany, został zarejestrowany jako nasłuchiwacz przechwytujący, czy nie.
Jeśli nasłuchiwacz został zarejestrowany dwukrotnie, raz z przechwytywaniem, a raz bez, każdy musi być usunięty osobno.
Usunięcie nasłuchiwacza przechwytującego nie wpływa na wersję nieprzechwytującą tego samego nasłuchiwacza i odwrotnie.