Class Event
Namespace: Aspose.Html.Dom.Events
Assembly: Aspose.HTML.dll (25.1.0)
Třída Aspose.Html.Dom.Events.Event se používá k poskytování kontextových informací o události zpracovávajícímu handleru.
[ComVisible(true)]
[DOMObject]
[DOMName("Event")]
public class Event : DOMObject, INotifyPropertyChanged
Dědičnost
Odvozené
CustomEvent, ErrorEvent, SVGZoomEvent, TimeEvent, UIEvent
Implementuje
Děděné členy
DOMObject.GetPlatformType(), object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Poznámky
Objekt, který implementuje Aspose.Html.Dom.Events.Event, je obvykle předán jako první parametr handleru události.
Specifičtější kontextové informace jsou předávány handlerům událostí odvozením dalších rozhraní z Aspose.Html.Dom.Events.Event,
která obsahují informace přímo související s typem události, kterou doprovázejí.
Tato odvozená rozhraní jsou také implementována objektem předaným posluchači událostí.
Konstruktor
Event(string)
Inicializuje novou instanci třídy Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type)
Parametry
type
string
Typ události.
Event(string, IDictionary<string, object="">)
Inicializuje novou instanci třídy Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type, IDictionary<string, object=""> eventInitDict)
Parametry
type
string
Typ události.
eventInitDict
IDictionary<string, object>
Slovník pro inicializaci události.
Pole
AtTargetPhase
Aktuální fáze události je fáze zachytávání.
[DOMName("AT_TARGET")]
public const ushort AtTargetPhase = 2
Hodnota pole
BubblingPhase
Aktuální fáze události je fáze bublání.
[DOMName("BUBBLING_PHASE")]
public const ushort BubblingPhase = 3
Hodnota pole
CapturingPhase
Událost je aktuálně vyhodnocována na cílovém Aspose.Html.Dom.Events.IEventTarget.
[DOMName("CAPTURING_PHASE")]
public const ushort CapturingPhase = 1
Hodnota pole
NonePhase
Události, které nejsou aktuálně odesílány, jsou v této fázi.
[DOMName("NONE")]
public const ushort NonePhase = 0
Hodnota pole
Vlastnosti
Bubbles
Používá se k označení, zda je událost událostí bublání. Pokud může událost bublat, je hodnota true, jinak je hodnota false.
[DOMName("bubbles")]
public bool Bubbles { get; }
Hodnota vlastnosti
Cancelable
Používá se k označení, zda může být zamezeno výchozí akci události. Pokud lze zamezit výchozí akci, je hodnota true, jinak je hodnota false.
[DOMName("cancelable")]
public bool Cancelable { get; }
Hodnota vlastnosti
CurrentTarget
Používá se k označení Aspose.Html.Dom.Events.IEventTarget, jehož Aspose.Html.Dom.Events.IEventListeners jsou aktuálně zpracovávány.
To je obzvlášť užitečné během zachytávání a bublání.
[DOMName("currentTarget")]
[DOMNullable]
public EventTarget CurrentTarget { get; }
Hodnota vlastnosti
DefaultPrevented
Vrací true, pokud byla metoda preventDefault() vyvolána, zatímco hodnota atributu cancelable je true, jinak vrací false.
[DOMName("defaultPrevented")]
public bool DefaultPrevented { get; }
Hodnota vlastnosti
EventPhase
Používá se k označení, která fáze toku události je aktuálně vyhodnocována.
[DOMName("eventPhase")]
public ushort EventPhase { get; }
Hodnota vlastnosti
IsTrusted
Atribut isTrusted musí vracet hodnotu, na kterou byl inicializován. Když je událost vytvořena, musí být atribut inicializován na false.
[DOMName("isTrusted")]
public bool IsTrusted { get; }
Hodnota vlastnosti
Target
Používá se k označení Aspose.Html.Dom.Events.IEventTarget, na který byla událost původně odeslána.
[DOMNullable]
[DOMName("target")]
public EventTarget Target { get; }
Hodnota vlastnosti
TimeStamp
Používá se k určení času (v milisekundách relativně k epoše), kdy byla událost vytvořena.
Vzhledem k tomu, že některé systémy nemusí poskytovat tyto informace, může být hodnota timeStamp nedostupná pro všechny události.
Pokud není dostupná, bude vrácena hodnota 0.
Příklady epochového času jsou čas spuštění systému nebo 0:0:0 UTC 1. ledna 1970.
[DOMName("timeStamp")]
public ulong TimeStamp { get; }
Hodnota vlastnosti
Type
Název události (bez ohledu na velikost písmen). Název musí být XML názvem.
[DOMName("type")]
public string Type { get; }
Hodnota vlastnosti
Metody
InitEvent(string, bool, bool)
Metoda Aspose.Html.Dom.Events.Event.InitEvent(System.String,System.Boolean,System.Boolean) se používá k inicializaci hodnoty události Aspose.Html.Dom.Events.Event vytvořené prostřednictvím
rozhraní Aspose.Html.Dom.Events.IDocumentEvent.
[DOMName("initEvent")]
public void InitEvent(string type, bool bubbles, bool cancelable)
Parametry
type
string
Typ události.
bubbles
bool
pokud je nastaveno na true
[bubbles].
cancelable
bool
pokud je nastaveno na true
[cancelable].
Poznámky
Tato metoda může být volána pouze před tím, než byla událost odeslána prostřednictvím metody Aspose.Html.Dom.Events.IEventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event),
ale může být volána vícekrát během této fáze, pokud je to nutné.
Pokud je volána vícekrát, poslední vyvolání má přednost.
Pokud je volána z podtřídy rozhraní Event, jsou modifikovány pouze hodnoty uvedené v metodě initEvent, všechny ostatní atributy zůstávají nezměněny.
PreventDefault()
Pokud je událost zrušitelná, metoda Aspose.Html.Dom.Events.Event.PreventDefault se používá k označení, že událost má být zrušena,
což znamená, že jakákoli výchozí akce, kterou běžně provádí implementace v důsledku události, se neprovede.
[DOMName("preventDefault")]
public void PreventDefault()
Poznámky
Pokud je během jakékoli fáze toku události volána metoda Aspose.Html.Dom.Events.Event.PreventDefault, událost je zrušena.
Jakákoli výchozí akce spojená s událostí se neprovede.
Volání této metody pro nezrušitelnou událost nemá žádný účinek.
Jakmile byla metoda Aspose.Html.Dom.Events.Event.PreventDefault volána, zůstane v platnosti po zbytek šíření události.
Tato metoda může být použita během jakékoli fáze toku události.
StopImmediatePropagation()
Vyvolání této metody zabrání události dosáhnout jakýchkoli posluchačů událostí registrovaných po aktuálním a při odeslání v rámci stromu také zabrání události dosáhnout jakýchkoli jiných objektů.
[DOMName("stopImmediatePropagation")]
public void StopImmediatePropagation()
StopPropagation()
Metoda Aspose.Html.Dom.Events.Event.StopPropagation se používá k zabránění dalšímu šíření události během toku události.
[DOMName("stopPropagation")]
public void StopPropagation()
Poznámky
Pokud tuto metodu zavolá jakýkoli Aspose.Html.Dom.Events.IEventListener, událost přestane šířit přes strom.
Událost bude dokončena odesláním všem posluchačům na aktuálním Aspose.Html.Dom.Events.IEventTarget před tím, než se šíření události zastaví.
Tato metoda může být použita během jakékoli fáze toku události.