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, чьи Aspose.Html.Dom.Events.IEventListeners в настоящее время обрабатываются.
Это особенно полезно во время захвата и всплытия.
[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 перед остановкой потока событий.
Этот метод может быть использован на любой стадии потока событий.
