Class Event
Namespace: Aspose.Html.Dom.Events
Assembly: Aspose.HTML.dll (25.1.0)
Aspose.Html.Dom.Events.Event được sử dụng để cung cấp thông tin ngữ cảnh về một sự kiện cho trình xử lý đang xử lý sự kiện đó.
[ComVisible(true)]
[DOMObject]
[DOMName("Event")]
public class Event : DOMObject, INotifyPropertyChangedKế thừa
Kế thừa
CustomEvent, ErrorEvent, SVGZoomEvent, TimeEvent, UIEvent
Triển khai
Thành viên kế thừa
DOMObject.GetPlatformType(), object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Nhận xét
Một đối tượng triển khai Aspose.Html.Dom.Events.Event thường được truyền như tham số đầu tiên cho một trình xử lý sự kiện.
Thông tin ngữ cảnh cụ thể hơn được truyền đến các trình xử lý sự kiện bằng cách kế thừa các giao diện bổ sung từ Aspose.Html.Dom.Events.Event
chứa thông tin liên quan trực tiếp đến loại sự kiện mà chúng đi kèm.
Các giao diện kế thừa này cũng được triển khai bởi đối tượng được truyền đến trình lắng nghe sự kiện.
Các hàm khởi tạo
Event(string)
Khởi tạo một thể hiện mới của lớp Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type)Tham số
type string
Loại sự kiện.
Event(string, IDictionary<string, object="">)
Khởi tạo một thể hiện mới của lớp Aspose.Html.Dom.Events.Event.
[DOMConstructor]
public Event(string type, IDictionary<string, object=""> eventInitDict)Tham số
type string
Loại sự kiện.
eventInitDict IDictionary<string, object>
Từ điển khởi tạo sự kiện.
Các trường
AtTargetPhase
Giai đoạn sự kiện hiện tại là giai đoạn bắt giữ.
[DOMName("AT_TARGET")]
public const ushort AtTargetPhase = 2Giá trị trường
BubblingPhase
Giai đoạn sự kiện hiện tại là giai đoạn nổi bọt.
[DOMName("BUBBLING_PHASE")]
public const ushort BubblingPhase = 3Giá trị trường
CapturingPhase
Sự kiện hiện đang được đánh giá tại Aspose.Html.Dom.Events.IEventTarget mục tiêu.
[DOMName("CAPTURING_PHASE")]
public const ushort CapturingPhase = 1Giá trị trường
NonePhase
Các sự kiện không được gửi hiện tại đang ở giai đoạn này.
[DOMName("NONE")]
public const ushort NonePhase = 0Giá trị trường
Các thuộc tính
Bubbles
Được sử dụng để chỉ ra liệu một sự kiện có phải là sự kiện nổi bọt hay không. Nếu sự kiện có thể nổi bọt thì giá trị là true, nếu không thì giá trị là false.
[DOMName("bubbles")]
public bool Bubbles { get; }Giá trị thuộc tính
Cancelable
Được sử dụng để chỉ ra liệu một sự kiện có thể ngăn chặn hành động mặc định của nó hay không. Nếu hành động mặc định có thể bị ngăn chặn thì giá trị là true, nếu không thì giá trị là false.
[DOMName("cancelable")]
public bool Cancelable { get; }Giá trị thuộc tính
CurrentTarget
Được sử dụng để chỉ ra Aspose.Html.Dom.Events.IEventTarget mà các Aspose.Html.Dom.Events.IEventListeners đang được xử lý.
Điều này đặc biệt hữu ích trong quá trình bắt giữ và nổi bọt.
[DOMName("currentTarget")]
[DOMNullable]
public EventTarget CurrentTarget { get; }Giá trị thuộc tính
DefaultPrevented
Trả về true nếu preventDefault() được gọi trong khi giá trị thuộc tính có thể bị hủy là true, và false nếu không.
[DOMName("defaultPrevented")]
public bool DefaultPrevented { get; }Giá trị thuộc tính
EventPhase
Được sử dụng để chỉ ra giai đoạn nào của luồng sự kiện đang được đánh giá.
[DOMName("eventPhase")]
public ushort EventPhase { get; }Giá trị thuộc tính
IsTrusted
Thuộc tính isTrusted phải trả về giá trị mà nó được khởi tạo. Khi một sự kiện được tạo, thuộc tính phải được khởi tạo là false.
[DOMName("isTrusted")]
public bool IsTrusted { get; }Giá trị thuộc tính
Target
Được sử dụng để chỉ ra Aspose.Html.Dom.Events.IEventTarget mà sự kiện ban đầu được gửi đến.
[DOMNullable]
[DOMName("target")]
public EventTarget Target { get; }Giá trị thuộc tính
TimeStamp
Được sử dụng để chỉ định thời gian (tính bằng mili giây so với thời điểm bắt đầu) mà sự kiện được tạo ra.
Do một số hệ thống có thể không cung cấp thông tin này, giá trị của timeStamp có thể không khả dụng cho tất cả các sự kiện.
Khi không khả dụng, giá trị 0 sẽ được trả về.
Ví dụ về thời gian bắt đầu là thời gian khởi động hệ thống hoặc 0:0:0 UTC ngày 1 tháng 1 năm 1970.
[DOMName("timeStamp")]
public ulong TimeStamp { get; }Giá trị thuộc tính
Type
Tên của sự kiện (không phân biệt chữ hoa chữ thường). Tên phải là một tên XML.
[DOMName("type")]
public string Type { get; }Giá trị thuộc tính
Các phương thức
InitEvent(string, bool, bool)
Phương thức Aspose.Html.Dom.Events.Event.InitEvent(System.String,System.Boolean,System.Boolean) được sử dụng để khởi tạo giá trị của một Aspose.Html.Dom.Events.Event được tạo thông qua
giao diện Aspose.Html.Dom.Events.IDocumentEvent.
[DOMName("initEvent")]
public void InitEvent(string type, bool bubbles, bool cancelable)Tham số
type string
Loại sự kiện.
bubbles bool
nếu được đặt thành true [bubbles].
cancelable bool
nếu được đặt thành true [cancelable].
Nhận xét
Phương thức này chỉ có thể được gọi trước khi Sự kiện được gửi qua phương thức Aspose.Html.Dom.Events.IEventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event),
mặc dù nó có thể được gọi nhiều lần trong giai đoạn đó nếu cần.
Nếu được gọi nhiều lần, lần gọi cuối cùng sẽ được ưu tiên.
Nếu được gọi từ một lớp con của giao diện Event, chỉ các giá trị được chỉ định trong phương thức initEvent sẽ được sửa đổi, tất cả các thuộc tính khác sẽ không thay đổi.
PreventDefault()
Nếu một sự kiện có thể hủy, phương thức Aspose.Html.Dom.Events.Event.PreventDefault được sử dụng để chỉ ra rằng sự kiện sẽ bị hủy,
có nghĩa là bất kỳ hành động mặc định nào thường được thực hiện bởi triển khai do sự kiện sẽ không xảy ra.
[DOMName("preventDefault")]
public void PreventDefault()Nhận xét
Nếu, trong bất kỳ giai đoạn nào của luồng sự kiện, phương thức Aspose.Html.Dom.Events.Event.PreventDefault được gọi, sự kiện sẽ bị hủy.
Bất kỳ hành động mặc định nào liên quan đến sự kiện sẽ không xảy ra.
Gọi phương thức này cho một sự kiện không thể hủy sẽ không có tác dụng.
Sau khi Aspose.Html.Dom.Events.Event.PreventDefault đã được gọi, nó sẽ vẫn có hiệu lực trong suốt phần còn lại của sự kiện.
Phương thức này có thể được sử dụng trong bất kỳ giai đoạn nào của luồng sự kiện.
StopImmediatePropagation()
Gọi phương thức này ngăn sự kiện đến bất kỳ trình lắng nghe sự kiện nào được đăng ký sau trình lắng nghe hiện tại và khi được gửi trong một cây cũng ngăn sự kiện đến bất kỳ đối tượng nào khác.
[DOMName("stopImmediatePropagation")]
public void StopImmediatePropagation()StopPropagation()
Phương thức Aspose.Html.Dom.Events.Event.StopPropagation được sử dụng để ngăn chặn sự kiện tiếp tục lan truyền trong luồng sự kiện.
[DOMName("stopPropagation")]
public void StopPropagation()Nhận xét
Nếu phương thức này được gọi bởi bất kỳ Aspose.Html.Dom.Events.IEventListener nào, sự kiện sẽ ngừng lan truyền qua cây.
Sự kiện sẽ hoàn tất việc gửi đến tất cả các trình lắng nghe trên Aspose.Html.Dom.Events.IEventTarget hiện tại trước khi luồng sự kiện dừng lại.
Phương thức này có thể được sử dụng trong bất kỳ giai đoạn nào của luồng sự kiện.
