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 ปัจจุบันก่อนที่การไหลของเหตุการณ์จะหยุด
วิธีนี้สามารถใช้ได้ในระยะใด ๆ ของการไหลของเหตุการณ์