Class Event
Namespace: Aspose.Html.Dom.Events
Assembly: Aspose.HTML.dll (25.1.0)
Aspose.Html.Dom.Events.Event jest używany do dostarczania kontekstowych informacji o zdarzeniu do obsługi, która przetwarza to zdarzenie.
[ComVisible(true)]
[DOMObject]
[DOMName("Event")]
public class Event : DOMObject, INotifyPropertyChangedDziedziczenie
Pochodne
CustomEvent, ErrorEvent, SVGZoomEvent, TimeEvent, UIEvent
Implementuje
Dziedziczone członkowie
DOMObject.GetPlatformType(), object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Uwagi
Obiekt, który implementuje Aspose.Html.Dom.Events.Event, jest zazwyczaj przekazywany jako pierwszy parametr do obsługi zdarzenia.
Bardziej szczegółowe informacje kontekstowe są przekazywane do obsług zdarzeń poprzez dziedziczenie dodatkowych interfejsów z Aspose.Html.Dom.Events.Event,
które zawierają informacje bezpośrednio związane z typem zdarzenia, które towarzyszą.
Te pochodne interfejsy są również implementowane przez obiekt przekazywany do nasłuchiwacza zdarzeń.
Konstruktory
Event(string)
Inicjalizuje nową instancję klasy Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type)Parametry
type string
Typ zdarzenia.
Event(string, IDictionary<string, object="">)
Inicjalizuje nową instancję klasy Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type, IDictionary<string, object=""> eventInitDict)Parametry
type string
Typ zdarzenia.
eventInitDict IDictionary<string, object>
Słownik inicjalizacyjny zdarzenia.
Pola
AtTargetPhase
Aktualna faza zdarzenia to faza przechwytywania.
[DOMName("AT_TARGET")]
public const ushort AtTargetPhase = 2Wartość pola
BubblingPhase
Aktualna faza zdarzenia to faza bąbelkowania.
[DOMName("BUBBLING_PHASE")]
public const ushort BubblingPhase = 3Wartość pola
CapturingPhase
Zdarzenie jest obecnie oceniane na docelowym Aspose.Html.Dom.Events.IEventTarget.
[DOMName("CAPTURING_PHASE")]
public const ushort CapturingPhase = 1Wartość pola
NonePhase
Zdarzenia, które nie są obecnie wysyłane, znajdują się w tej fazie.
[DOMName("NONE")]
public const ushort NonePhase = 0Wartość pola
Właściwości
Bubbles
Używane do wskazania, czy zdarzenie jest zdarzeniem bąbelkującym. Jeśli zdarzenie może bąbelkować, wartość jest prawdziwa, w przeciwnym razie wartość jest fałszywa.
[DOMName("bubbles")]
public bool Bubbles { get; }Wartość właściwości
Cancelable
Używane do wskazania, czy zdarzenie może mieć swoją domyślną akcję zablokowaną. Jeśli domyślna akcja może być zablokowana, wartość jest prawdziwa, w przeciwnym razie wartość jest fałszywa.
[DOMName("cancelable")]
public bool Cancelable { get; }Wartość właściwości
CurrentTarget
Używane do wskazania Aspose.Html.Dom.Events.IEventTarget, którego Aspose.Html.Dom.Events.IEventListeners są obecnie przetwarzane.
Jest to szczególnie przydatne podczas przechwytywania i bąbelkowania.
[DOMName("currentTarget")]
[DOMNullable]
public EventTarget CurrentTarget { get; }Wartość właściwości
DefaultPrevented
Zwraca prawdę, jeśli preventDefault() zostało wywołane, gdy wartość atrybutu cancelable jest prawdziwa, a w przeciwnym razie fałsz.
[DOMName("defaultPrevented")]
public bool DefaultPrevented { get; }Wartość właściwości
EventPhase
Używane do wskazania, która faza przepływu zdarzeń jest obecnie oceniana.
[DOMName("eventPhase")]
public ushort EventPhase { get; }Wartość właściwości
IsTrusted
Atrybut isTrusted musi zwracać wartość, z którą został zainicjalizowany. Gdy zdarzenie jest tworzone, atrybut musi być zainicjalizowany na fałsz.
[DOMName("isTrusted")]
public bool IsTrusted { get; }Wartość właściwości
Target
Używane do wskazania Aspose.Html.Dom.Events.IEventTarget, do którego zdarzenie zostało pierwotnie wysłane.
[DOMNullable]
[DOMName("target")]
public EventTarget Target { get; }Wartość właściwości
TimeStamp
Używane do określenia czasu (w milisekundach względem epoki), w którym zdarzenie zostało utworzone.
Z powodu faktu, że niektóre systemy mogą nie dostarczać tych informacji, wartość timeStamp może być niedostępna dla wszystkich zdarzeń.
Gdy nie jest dostępna, zwracana jest wartość 0.
Przykłady czasu epoki to czas uruchomienia systemu lub 0:0:0 UTC 1 stycznia 1970.
[DOMName("timeStamp")]
public ulong TimeStamp { get; }Wartość właściwości
Type
Nazwa zdarzenia (niezależna od wielkości liter). Nazwa musi być nazwą XML.
[DOMName("type")]
public string Type { get; }Wartość właściwości
Metody
InitEvent(string, bool, bool)
Metoda Aspose.Html.Dom.Events.Event.InitEvent(System.String,System.Boolean,System.Boolean) jest używana do inicjalizacji wartości Aspose.Html.Dom.Events.Event utworzonego za pomocą
interfejsu Aspose.Html.Dom.Events.IDocumentEvent.
[DOMName("initEvent")]
public void InitEvent(string type, bool bubbles, bool cancelable)Parametry
type string
Typ zdarzenia.
bubbles bool
jeśli ustawione na true [bubbles].
cancelable bool
jeśli ustawione na true [cancelable].
Uwagi
Ta metoda może być wywoływana tylko przed tym, jak zdarzenie zostało wysłane za pomocą metody Aspose.Html.Dom.Events.IEventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event),
choć może być wywoływana wielokrotnie w tej fazie, jeśli to konieczne.
Jeśli wywołana wielokrotnie, ostatnie wywołanie ma pierwszeństwo.
Jeśli wywołana z podklasy interfejsu Event, tylko wartości określone w metodzie initEvent są modyfikowane, wszystkie inne atrybuty pozostają niezmienione.
PreventDefault()
Jeśli zdarzenie jest anulowalne, metoda Aspose.Html.Dom.Events.Event.PreventDefault jest używana do oznaczenia, że zdarzenie ma być anulowane,
co oznacza, że jakakolwiek domyślna akcja normalnie podejmowana przez implementację w wyniku zdarzenia nie wystąpi.
[DOMName("preventDefault")]
public void PreventDefault()Uwagi
Jeśli w dowolnym etapie przepływu zdarzeń metoda Aspose.Html.Dom.Events.Event.PreventDefault jest wywoływana, zdarzenie jest anulowane.
Jakakolwiek domyślna akcja związana z tym zdarzeniem nie wystąpi.
Wywołanie tej metody dla nieanulowalnego zdarzenia nie ma wpływu.
Po wywołaniu Aspose.Html.Dom.Events.Event.PreventDefault pozostanie w mocy przez resztę propagacji zdarzenia.
Ta metoda może być używana w dowolnym etapie przepływu zdarzeń.
StopImmediatePropagation()
Wywołanie tej metody zapobiega dotarciu zdarzenia do jakichkolwiek nasłuchiwaczy zdarzeń zarejestrowanych po obecnym oraz, gdy jest wysyłane w drzewie, również zapobiega dotarciu zdarzenia do jakichkolwiek innych obiektów.
[DOMName("stopImmediatePropagation")]
public void StopImmediatePropagation()StopPropagation()
Metoda Aspose.Html.Dom.Events.Event.StopPropagation jest używana do zapobiegania dalszej propagacji zdarzenia podczas przepływu zdarzeń.
[DOMName("stopPropagation")]
public void StopPropagation()Uwagi
Jeśli ta metoda zostanie wywołana przez jakiegokolwiek Aspose.Html.Dom.Events.IEventListener, zdarzenie przestanie się propagować przez drzewo.
Zdarzenie zakończy wysyłanie do wszystkich nasłuchiwaczy na bieżącym Aspose.Html.Dom.Events.IEventTarget przed zatrzymaniem przepływu zdarzenia.
Ta metoda może być używana w dowolnym etapie przepływu zdarzeń.
