Class EventTarget

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

رابطه Aspose.Html.Dom.EventTarget توسط تمام نودها در یک پیاده‌سازی که مدل رویداد DOM را پشتیبانی می‌کند، پیاده‌سازی شده است.
بنابراین، این رابط می‌تواند با استفاده از روش‌های تبدیل خاص بایندینگ بر روی یک نمونه از رابط Node به دست آید.
این رابط اجازه ثبت و حذف شنونده‌های رویداد را بر روی Aspose.Html.Dom.EventTarget و ارسال رویدادها به آن Aspose.Html.Dom.Events.IEventTarget می‌دهد.

[ComVisible(true)]
[DOMName("EventTarget")]
[DOMObject]
public class EventTarget : DOMObject, INotifyPropertyChanged, IEventTarget, IDisposable

وراثت

object ← DOMObject ← EventTarget

مشتق

MediaQueryList, Node

پیاده‌سازی

INotifyPropertyChanged, IEventTarget, IDisposable

اعضای وراثت‌یافته

DOMObject.GetPlatformType(), object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

سازنده‌ها

EventTarget()

public EventTarget()

متدها

AddEventListener(string, DOMEventHandler, bool)

این متد اجازه ثبت شنونده‌های رویداد را بر روی هدف رویداد می‌دهد.

public void AddEventListener(string type, DOMEventHandler handler, bool useCapture)

پارامترها

type string

نوع رویداد که کاربر برای آن ثبت‌نام می‌کند.

handler DOMEventHandler

یک Aspose.Html.Dom.Events.DOMEventHandler را می‌گیرد که هنگام وقوع رویداد فراخوانی خواهد شد.

useCapture bool

اگر true باشد، useCapture نشان می‌دهد که کاربر می‌خواهد capture را آغاز کند.
پس از آغاز capture، تمام رویدادهای نوع مشخص شده به Aspose.Html.Dom.Events.IEventListener ثبت شده ارسال می‌شوند
قبل از اینکه به هر هدف رویداد دیگری در درخت ارسال شوند.
رویدادهایی که از طریق درخت به سمت بالا در حال حباب زدن هستند، شنونده Aspose.Html.Dom.Events.IEventListener که برای استفاده از capture تعیین شده است را فعال نخواهند کرد.

توضیحات

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

اگر چندین شنونده رویداد مشابه با همان پارامترها بر روی یک Aspose.Html.Dom.EventTarget ثبت شوند، نمونه‌های تکراریDiscard می‌شوند. این نمونه‌ها باعث نمی‌شوند که Aspose.Html.Dom.Events.IEventListener دو بار فراخوانی شود و از آنجا که آنهاDiscard شده‌اند، نیازی به حذف آنها با Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean) نیست.

AddEventListener(string, IEventListener)

این متد اجازه ثبت شنونده‌های رویداد را بر روی هدف رویداد می‌دهد.

public void AddEventListener(string type, IEventListener listener)

پارامترها

type string

نوع رویداد که کاربر برای آن ثبت‌نام می‌کند.

listener IEventListener

یک رابط پیاده‌سازی شده توسط کاربر را می‌گیرد که شامل متدهایی است که هنگام وقوع رویداد فراخوانی خواهند شد.

توضیحات

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

اگر چندین شنونده رویداد مشابه با همان پارامترها بر روی یک Aspose.Html.Dom.EventTarget ثبت شوند، نمونه‌های تکراریDiscard می‌شوند. این نمونه‌ها باعث نمی‌شوند که Aspose.Html.Dom.Events.IEventListener دو بار فراخوانی شود و از آنجا که آنهاDiscard شده‌اند، نیازی به حذف آنها با Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean) نیست.

AddEventListener(string, IEventListener, bool)

این متد اجازه ثبت شنونده‌های رویداد را بر روی هدف رویداد می‌دهد.

public void AddEventListener(string type, IEventListener listener, bool useCapture)

پارامترها

type string

نوع رویداد که کاربر برای آن ثبت‌نام می‌کند.

listener IEventListener

یک رابط پیاده‌سازی شده توسط کاربر را می‌گیرد که شامل متدهایی است که هنگام وقوع رویداد فراخوانی خواهند شد.

useCapture bool

اگر true باشد، useCapture نشان می‌دهد که کاربر می‌خواهد capture را آغاز کند.
پس از آغاز capture، تمام رویدادهای نوع مشخص شده به Aspose.Html.Dom.Events.IEventListener ثبت شده ارسال می‌شوند
قبل از اینکه به هر هدف رویداد دیگری در درخت ارسال شوند.
رویدادهایی که از طریق درخت به سمت بالا در حال حباب زدن هستند، شنونده Aspose.Html.Dom.Events.IEventListener که برای استفاده از capture تعیین شده است را فعال نخواهند کرد.

توضیحات

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

اگر چندین شنونده رویداد مشابه با همان پارامترها بر روی یک Aspose.Html.Dom.EventTarget ثبت شوند، نمونه‌های تکراریDiscard می‌شوند. این نمونه‌ها باعث نمی‌شوند که Aspose.Html.Dom.Events.IEventListener دو بار فراخوانی شود و از آنجا که آنهاDiscard شده‌اند، نیازی به حذف آنها با Aspose.Html.Dom.EventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.DOMEventHandler,System.Boolean) نیست.

DispatchEvent(Event)

این متد اجازه ارسال رویدادها به مدل رویدادهای پیاده‌سازی را می‌دهد.

public 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 است.

توضیحات

رویدادهایی که به این روش ارسال می‌شوند، رفتار حباب زدن و capture مشابهی با رویدادهایی که مستقیماً توسط پیاده‌سازی ارسال می‌شوند خواهند داشت.
هدف رویداد، Aspose.Html.Dom.EventTarget است که در آن Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) فراخوانی می‌شود.

استثناها

DOMException

Dispose()

وظایف تعریف شده توسط برنامه را انجام می‌دهد که مربوط به آزادسازی، رهاسازی یا بازنشانی منابع غیرمدیریتی است.

public void Dispose()

Dispose(bool)

منابع غیرمدیریتی و - به طور اختیاری - منابع مدیریتی را آزاد می‌کند.

protected virtual void Dispose(bool disposing)

پارامترها

disposing bool

true برای آزادسازی هر دو منبع مدیریتی و غیرمدیریتی؛ false برای آزادسازی تنها منابع غیرمدیریتی.

RemoveEventListener(string, DOMEventHandler, bool)

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

public void RemoveEventListener(string type, DOMEventHandler handler, bool useCapture)

پارامترها

type string

نوع رویداد Aspose.Html.Dom.Events.IEventListener که در حال حذف است را مشخص می‌کند.

handler DOMEventHandler

پارامتر Aspose.Html.Dom.Events.DOMEventHandler نشان‌دهنده Aspose.Html.Dom.Events.IEventListener است که باید حذف شود.

useCapture bool

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

RemoveEventListener(string, IEventListener)

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

public 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 در حین پردازش یک رویداد حذف شود، توسط اقدامات فعلی فعال نخواهد شد.
شنونده‌های رویداد هرگز پس از حذف نمی‌توانند فراخوانی شوند.

public 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

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