Class EventTarget

Namespace: Aspose.Html.Dom
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 powiązania metod rzutowania na instancję interfejsu Node.
Interfejs pozwala na rejestrację i usuwanie nasłuchiwaczy zdarzeń na Aspose.Html.Dom.EventTarget oraz na dispatching zdarzeń do tego Aspose.Html.Dom.Events.IEventTarget.

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

Dziedziczenie

object ← DOMObject ← EventTarget

Pochodne

MediaQueryList, Node

Implementuje

INotifyPropertyChanged, IEventTarget, IDisposable

Członkowie dziedziczeni

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

Konstruktory

EventTarget()

public EventTarget()

Metody

AddEventListener(string, DOMEventHandler, bool)

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

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

Parametry

type string

Typ zdarzenia, dla którego użytkownik rejestruje

handler DOMEventHandler

Przyjmuje Aspose.Html.Dom.Events.DOMEventHandler, który ma być wywołany, gdy zdarzenie wystąpi.

useCapture bool

Jeśli true, useCapture wskazuje, że użytkownik chce rozpocząć przechwytywanie.
Po rozpoczęciu przechwytywania, wszystkie zdarzenia określonego typu będą przesyłane do zarejestrowanego
Aspose.Html.Dom.Events.IEventListener
zanim zostaną przesłane do jakichkolwiek obiektów docelowych zdarzeń poniżej nich w drzewie.
Zdarzenia, które są wznoszące się w górę przez drzewo, nie uruchomią Aspose.Html.Dom.Events.IEventListener zaprojektowanego do używania przechwytywania.

Uwagi

Jeśli Aspose.Html.Dom.Events.IEventListener zostanie dodany do Aspose.Html.Dom.EventTarget podczas przetwarzania zdarzenia, nie zostanie on wywołany przez bieżące działania, ale może zostać wywołany podczas późniejszego etapu przepływu zdarzeń, takiego jak faza wznoszenia.

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

AddEventListener(string, IEventListener)

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

public void AddEventListener(string type, IEventListener listener)

Parametry

type string

Typ zdarzenia, dla którego użytkownik rejestruje

listener IEventListener

Przyjmuje interfejs zaimplementowany przez użytkownika, który zawiera metody, które mają być wywołane, gdy zdarzenie wystąpi.

Uwagi

Jeśli Aspose.Html.Dom.Events.IEventListener zostanie dodany do Aspose.Html.Dom.EventTarget podczas przetwarzania zdarzenia, nie zostanie on wywołany przez bieżące działania, ale może zostać wywołany podczas późniejszego etapu przepływu zdarzeń, takiego jak faza wznoszenia.

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

AddEventListener(string, IEventListener, bool)

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

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

Parametry

type string

Typ zdarzenia, dla którego użytkownik rejestruje

listener IEventListener

Przyjmuje interfejs zaimplementowany przez użytkownika, który zawiera metody, które mają być wywołane, gdy zdarzenie wystąpi.

useCapture bool

Jeśli true, useCapture wskazuje, że użytkownik chce rozpocząć przechwytywanie.
Po rozpoczęciu przechwytywania, wszystkie zdarzenia określonego typu będą przesyłane do zarejestrowanego
Aspose.Html.Dom.Events.IEventListener
zanim zostaną przesłane do jakichkolwiek obiektów docelowych zdarzeń poniżej nich w drzewie.
Zdarzenia, które są wznoszące się w górę przez drzewo, nie uruchomią Aspose.Html.Dom.Events.IEventListener zaprojektowanego do używania przechwytywania.

Uwagi

Jeśli Aspose.Html.Dom.Events.IEventListener zostanie dodany do Aspose.Html.Dom.EventTarget podczas przetwarzania zdarzenia, nie zostanie on wywołany przez bieżące działania, ale może zostać wywołany podczas późniejszego etapu przepływu zdarzeń, takiego jak faza wznoszenia.

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

DispatchEvent(Event)

Ta metoda pozwala na dispatching zdarzeń do modelu zdarzeń implementacji.

public bool DispatchEvent(Event @event)

Parametry

event Event

Określa typ zdarzenia, zachowanie i kontekstowe informacje, 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ługiwali zdarzenie, wywołał Aspose.Html.Dom.Events.Event.PreventDefault.
Jeśli Aspose.Html.Dom.Events.Event.PreventDefault został wywołany, wartość jest false, w przeciwnym razie wartość jest true.

Uwagi

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

Wyjątki

DOMException

Dispose()

Wykonuje zadania zdefiniowane przez aplikację związane z uwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów.

public void Dispose()

Dispose(bool)

Zwalnia zasoby niezarządzane i - opcjonalnie - zarządzane.

protected virtual void Dispose(bool disposing)

Parametry

disposing bool

true aby zwolnić zarówno zarządzane, jak i niezarządzane zasoby; false aby zwolnić tylko zasoby niezarządzane.

RemoveEventListener(string, DOMEventHandler, bool)

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

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

Parametry

type string

Określa typ zdarzenia Aspose.Html.Dom.Events.IEventListener, który jest usuwany.

handler DOMEventHandler

Parametr Aspose.Html.Dom.Events.DOMEventHandler 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 jako przechwytujący, a raz jako nieprzechwytujący, każdy musi być usunięty osobno.
Usunięcie nasłuchiwacza przechwytującego nie wpływa na nieprzechwytującą wersję tego samego nasłuchiwacza i odwrotnie.

RemoveEventListener(string, IEventListener)

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

public void RemoveEventListener(string type, IEventListener listener)

Parametry

type string

Określa typ zdarzenia Aspose.Html.Dom.Events.IEventListener, który jest usuwany.

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 zdarzeń.
Jeśli Aspose.Html.Dom.Events.IEventListener zostanie usunięty z Aspose.Html.Dom.EventTarget podczas przetwarzania zdarzenia, nie zostanie on wywołany przez bieżące działania.
Nasłuchiwacze zdarzeń nigdy nie mogą być wywołani po ich usunięciu.

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

Parametry

type string

Określa typ zdarzenia Aspose.Html.Dom.Events.IEventListener, który jest usuwany.

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 jako przechwytujący, a raz jako nieprzechwytujący, każdy musi być usunięty osobno.
Usunięcie nasłuchiwacza przechwytującego nie wpływa na nieprzechwytującą wersję tego samego nasłuchiwacza i odwrotnie.