Interface IEventTarget

Namespace: Aspose.Html.Dom.Events
Assembly: Aspose.HTML.dll (25.1.0)

تُنفذ واجهة Aspose.Html.Dom.EventTarget من قبل جميع العقد في تنفيذ يدعم نموذج حدث DOM.
لذلك، يمكن الحصول على هذه الواجهة باستخدام طرق تحويل محددة للربط على مثيل واجهة Node.
تسمح الواجهة بتسجيل وإزالة مستمعي الأحداث على Aspose.Html.Dom.EventTarget وإرسال الأحداث إلى تلك Aspose.Html.Dom.Events.IEventTarget.

[ComVisible(true)]
[DOMNoInterfaceObject]
public interface IEventTarget

الطرق

AddEventListener(string, IEventListener)

تسمح هذه الطريقة بتسجيل مستمعي الأحداث على هدف الحدث.

[DOMName("addEventListener")]
void AddEventListener(string type, IEventListener listener)

المعلمات

type string

نوع الحدث الذي يقوم المستخدم بالتسجيل له

listener IEventListener

تأخذ واجهة ينفذها المستخدم تحتوي على الطرق التي سيتم استدعاؤها عند حدوث الحدث.

ملاحظات

إذا تم إضافة Aspose.Html.Dom.Events.IEventListener إلى Aspose.Html.Dom.EventTarget أثناء معالجته لحدث، فلن يتم تفعيله بواسطة الإجراءات الحالية ولكن قد يتم تفعيله خلال مرحلة لاحقة من تدفق الحدث، مثل مرحلة الفقاعات.

إذا تم تسجيل عدة مستمعين متطابقين للأحداث على نفس Aspose.Html.Dom.EventTarget بنفس المعلمات، يتم تجاهل النسخ المكررة. لا تتسبب في استدعاء Aspose.Html.Dom.Events.IEventListener مرتين، ونظرًا لأنها تم تجاهلها، فهي لا تحتاج إلى الإزالة باستخدام Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener) الطريقة.

AddEventListener(string, IEventListener, bool)

تسمح هذه الطريقة بتسجيل مستمعي الأحداث على هدف الحدث.

[DOMName("addEventListener")]
void AddEventListener(string type, IEventListener listener, bool useCapture)

المعلمات

type string

نوع الحدث الذي يقوم المستخدم بالتسجيل له

listener IEventListener

تأخذ واجهة ينفذها المستخدم تحتوي على الطرق التي سيتم استدعاؤها عند حدوث الحدث.

useCapture bool

إذا كانت القيمة true، تشير useCapture إلى أن المستخدم يرغب في بدء الالتقاط.
بعد بدء الالتقاط، سيتم إرسال جميع الأحداث من النوع المحدد إلى Aspose.Html.Dom.Events.IEventListener المسجل
قبل إرسالها إلى أي أهداف أحداث تحتها في الشجرة.
لن تؤدي الأحداث التي تتجه لأعلى عبر الشجرة إلى تفعيل Aspose.Html.Dom.Events.IEventListener المعين لاستخدام الالتقاط.

ملاحظات

DispatchEvent(Event)

تسمح هذه الطريقة بإرسال الأحداث إلى نموذج الحدث في التنفيذ.

[DOMName("dispatchEvent")]
bool DispatchEvent(Event @event)

المعلمات

event Event

يحدد نوع الحدث والسلوك والمعلومات السياقية التي ستستخدم في معالجة الحدث.

القيم المرجعة

bool

تشير القيمة المرجعة من Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) إلى ما إذا كانت أي من المستمعين الذين تعاملوا مع الحدث قد استدعت Aspose.Html.Dom.Events.Event.PreventDefault.
إذا تم استدعاء Aspose.Html.Dom.Events.Event.PreventDefault، تكون القيمة false، وإلا تكون القيمة true.

ملاحظات

سيكون للأحداث التي تم إرسالها بهذه الطريقة نفس سلوك الالتقاط والفقاعات مثل الأحداث التي تم إرسالها مباشرة من قبل التنفيذ.
هدف الحدث هو Aspose.Html.Dom.EventTarget الذي يتم استدعاء عليه Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event).

الاستثناءات

DOMException

RemoveEventListener(string, IEventListener)

تسمح هذه الطريقة بإزالة مستمعي الأحداث من هدف الحدث.
إذا تمت إزالة Aspose.Html.Dom.Events.IEventListener من Aspose.Html.Dom.EventTarget أثناء معالجته لحدث، فلن يتم تفعيله بواسطة الإجراءات الحالية.
لا يمكن استدعاء مستمعي الأحداث بعد إزالتهم.

[DOMName("removeEventListener")]
void RemoveEventListener(string type, IEventListener listener)

المعلمات

type string

يحدد نوع الحدث لـ Aspose.Html.Dom.Events.IEventListener الذي يتم إزالته.

listener IEventListener

تشير معلمة Aspose.Html.Dom.Events.IEventListener إلى Aspose.Html.Dom.Events.IEventListener الذي سيتم إزالته.

RemoveEventListener(string, IEventListener, bool)

[DOMName("removeEventListener")]
void RemoveEventListener(string type, IEventListener listener, bool useCapture)

المعلمات

type string

يحدد نوع الحدث لـ Aspose.Html.Dom.Events.IEventListener الذي يتم إزالته.

listener IEventListener

تشير معلمة Aspose.Html.Dom.Events.IEventListener إلى Aspose.Html.Dom.Events.IEventListener الذي سيتم إزالته.

useCapture bool

يحدد ما إذا كان مستمع الحدث الذي يتم إزالته قد تم تسجيله كمستمع للالتقاط أم لا.
إذا تم تسجيل مستمع مرتين، واحدة مع الالتقاط وواحدة بدون، يجب إزالة كل منهما بشكل منفصل.
إزالة مستمع الالتقاط لا تؤثر على النسخة غير الملتقطة من نفس المستمع، والعكس صحيح.