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 که برای استفاده از ضبط مشخص شده است را تحریک نخواهند کرد.

توضیحات

اگر یک 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) ندارند.

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)

این روش اجازه حذف شنونده‌های رویداد را از هدف رویداد می‌دهد.
اگر یک Aspose.Html.Dom.Events.IEventListener از یک Aspose.Html.Dom.EventTarget در حین پردازش یک رویداد حذف شود، توسط اقدامات فعلی تحریک نخواهد شد.
شنونده‌های رویداد هرگز پس از حذف نمی‌توانند فراخوانی شوند.

[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

مشخص می‌کند که آیا شنونده‌ای که در حال حذف است به عنوان یک شنونده ضبط ثبت شده است یا نه.
اگر یک شنونده دو بار ثبت شده باشد، یکی با ضبط و دیگری بدون آن، هر کدام باید به طور جداگانه حذف شوند.
حذف یک شنونده ضبط بر نسخه غیرضبط همان شنونده تأثیری نخواهد داشت و بالعکس.