Class Event
Namespace: Aspose.Html.Dom.Events
Assembly: Aspose.HTML.dll (25.1.0)
Клас Aspose.Html.Dom.Events.Event використовується для надання контекстної інформації про подію обробнику, що обробляє цю подію.
[ComVisible(true)]
[DOMObject]
[DOMName("Event")]
public class Event : DOMObject, INotifyPropertyChangedНаслідування
Похідні
CustomEvent, ErrorEvent, SVGZoomEvent, TimeEvent, UIEvent
Реалізує
Наслідувані члени
DOMObject.GetPlatformType(), object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Примітки
Об’єкт, який реалізує Aspose.Html.Dom.Events.Event, зазвичай передається як перший параметр обробнику подій.
Більш специфічна контекстна інформація передається обробникам подій шляхом наслідування додаткових інтерфейсів від Aspose.Html.Dom.Events.Event,
які містять інформацію, безпосередньо пов’язану з типом події, яку вони супроводжують.
Ці похідні інтерфейси також реалізуються об’єктом, переданим слухачеві подій.
Конструктори
Event(string)
Ініціалізує новий екземпляр класу Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type)Параметри
type string
Тип події.
Event(string, IDictionary<string, object="">)
Ініціалізує новий екземпляр класу Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type, IDictionary<string, object=""> eventInitDict)Параметри
type string
Тип події.
eventInitDict IDictionary<string, object>
Словник ініціалізації події.
Поля
AtTargetPhase
Поточна фаза події - це фаза захоплення.
[DOMName("AT_TARGET")]
public const ushort AtTargetPhase = 2Значення поля
BubblingPhase
Поточна фаза події - це фаза спливаючої події.
[DOMName("BUBBLING_PHASE")]
public const ushort BubblingPhase = 3Значення поля
CapturingPhase
Подія в даний момент оцінюється на цільовому Aspose.Html.Dom.Events.IEventTarget.
[DOMName("CAPTURING_PHASE")]
public const ushort CapturingPhase = 1Значення поля
NonePhase
Події, які в даний момент не відправляються, знаходяться в цій фазі.
[DOMName("NONE")]
public const ushort NonePhase = 0Значення поля
Властивості
Bubbles
Використовується для вказівки, чи є подія спливаючою. Якщо подія може спливати, значення - true, інакше - false.
[DOMName("bubbles")]
public bool Bubbles { get; }Значення властивості
Cancelable
Використовується для вказівки, чи можна запобігти виконанню дії за замовчуванням для події. Якщо дію за замовчуванням можна запобігти, значення - true, інакше - false.
[DOMName("cancelable")]
public bool Cancelable { get; }Значення властивості
CurrentTarget
Використовується для вказівки Aspose.Html.Dom.Events.IEventTarget, обробники подій якого в даний момент обробляються.
Це особливо корисно під час захоплення та спливання.
[DOMName("currentTarget")]
[DOMNullable]
public EventTarget CurrentTarget { get; }Значення властивості
DefaultPrevented
Повертає true, якщо preventDefault() було викликано, коли значення атрибута cancelable - true, і false в іншому випадку.
[DOMName("defaultPrevented")]
public bool DefaultPrevented { get; }Значення властивості
EventPhase
Використовується для вказівки, яка фаза потоку подій в даний момент оцінюється.
[DOMName("eventPhase")]
public ushort EventPhase { get; }Значення властивості
IsTrusted
Атрибут isTrusted повинен повертати значення, з яким він був ініціалізований. Коли подія створюється, атрибут повинен бути ініціалізований як false.
[DOMName("isTrusted")]
public bool IsTrusted { get; }Значення властивості
Target
Використовується для вказівки Aspose.Html.Dom.Events.IEventTarget, до якого спочатку була надіслана подія.
[DOMNullable]
[DOMName("target")]
public EventTarget Target { get; }Значення властивості
TimeStamp
Використовується для вказівки часу (в мілісекундах від початку епохи), коли була створена подія.
У зв’язку з тим, що деякі системи можуть не надавати цю інформацію, значення timeStamp може бути недоступним для всіх подій.
Коли недоступно, буде повернено значення 0.
Приклади епохи - це час запуску системи або 0:0:0 UTC 1 січня 1970 року.
[DOMName("timeStamp")]
public ulong TimeStamp { get; }Значення властивості
Type
Назва події (регістр не має значення). Назва повинна бути XML-іменем.
[DOMName("type")]
public string Type { get; }Значення властивості
Методи
InitEvent(string, bool, bool)
Метод Aspose.Html.Dom.Events.Event.InitEvent(System.String,System.Boolean,System.Boolean) використовується для ініціалізації значення Aspose.Html.Dom.Events.Event, створеного через
інтерфейс Aspose.Html.Dom.Events.IDocumentEvent.
[DOMName("initEvent")]
public void InitEvent(string type, bool bubbles, bool cancelable)Параметри
type string
Тип події.
bubbles bool
якщо встановлено в true [bubbles].
cancelable bool
якщо встановлено в true [cancelable].
Примітки
Цей метод можна викликати лише до того, як подія була надіслана через метод Aspose.Html.Dom.Events.IEventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event),
хоча його можна викликати кілька разів під час цієї фази, якщо це необхідно.
Якщо викликано кілька разів, останнє викликання має пріоритет.
Якщо викликано з підкласу інтерфейсу Event, лише значення, вказані в методі initEvent, змінюються, всі інші атрибути залишаються незмінними.
PreventDefault()
Якщо подія є скасованою, метод Aspose.Html.Dom.Events.Event.PreventDefault використовується для позначення того, що подія має бути скасована,
що означає, що будь-яка дія за замовчуванням, яку зазвичай виконує реалізація внаслідок події, не відбудеться.
[DOMName("preventDefault")]
public void PreventDefault()Примітки
Якщо під час будь-якого етапу потоку подій метод Aspose.Html.Dom.Events.Event.PreventDefault викликано, подія скасовується.
Будь-яка дія за замовчуванням, пов’язана з подією, не відбудеться.
Виклик цього методу для нескасованої події не має жодного ефекту.
Після виклику Aspose.Html.Dom.Events.Event.PreventDefault він залишиться в дії протягом решти часу поширення події.
Цей метод може бути використаний під час будь-якого етапу потоку подій.
StopImmediatePropagation()
Виклик цього методу запобігає досягненню події будь-яких слухачів подій, зареєстрованих після поточного, і, коли подія надсилається в дереві, також запобігає досягненню події будь-яких інших об’єктів.
[DOMName("stopImmediatePropagation")]
public void StopImmediatePropagation()StopPropagation()
Метод Aspose.Html.Dom.Events.Event.StopPropagation використовується для запобігання подальшому поширенню події під час потоку подій.
[DOMName("stopPropagation")]
public void StopPropagation()Примітки
Якщо цей метод викликано будь-яким Aspose.Html.Dom.Events.IEventListener, подія перестане поширюватися через дерево.
Подія завершить відправку всім слухачам на поточному Aspose.Html.Dom.Events.IEventTarget перед зупинкою потоку подій.
Цей метод може бути використаний під час будь-якого етапу потоку подій.
