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.
أمثلة على وقت الحقبة هي وقت بدء النظام أو 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 الحالي قبل أن يتوقف تدفق الحدث.
يمكن استخدام هذه الطريقة خلال أي مرحلة من مراحل تدفق الحدث.
