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(),则返回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。
纪元时间的示例包括系统启动时间或1970年1月1日0:0:0 UTC。
[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.IDocumentEvent接口创建的Aspose.Html.Dom.Events.Event的值。
[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上完成调度到所有监听器,然后事件流停止。
此方法可以在事件流的任何阶段使用。