Class Event

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

وراثت

object ← DOMObject ← Event

مشتق شده

CustomEvent, ErrorEvent, SVGZoomEvent, TimeEvent, UIEvent

پیاده‌سازی‌ها

INotifyPropertyChanged

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

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&gt;

دایره‌المعارف مقداردهی اولیه رویداد.

فیلدها

AtTargetPhase

مرحله رویداد جاری، مرحله گرفتن است.

[DOMName("AT_TARGET")]
public const ushort AtTargetPhase = 2

مقدار فیلد

ushort

BubblingPhase

مرحله رویداد جاری، مرحله حبابی است.

[DOMName("BUBBLING_PHASE")]
public const ushort BubblingPhase = 3

مقدار فیلد

ushort

CapturingPhase

رویداد در حال حاضر در حال ارزیابی در هدف Aspose.Html.Dom.Events.IEventTarget است.

[DOMName("CAPTURING_PHASE")]
public const ushort CapturingPhase = 1

مقدار فیلد

ushort

NonePhase

رویدادهایی که در حال حاضر ارسال نشده‌اند در این مرحله هستند.

[DOMName("NONE")]
public const ushort NonePhase = 0

مقدار فیلد

ushort

ویژگی‌ها

Bubbles

برای نشان دادن اینکه آیا یک رویداد، رویداد حبابی است یا خیر استفاده می‌شود. اگر رویداد بتواند حبابی شود، مقدار true است، در غیر این صورت مقدار false است.

[DOMName("bubbles")]
public bool Bubbles { get; }

مقدار ویژگی

bool

Cancelable

برای نشان دادن اینکه آیا یک رویداد می‌تواند عمل پیش‌فرض خود را متوقف کند یا خیر استفاده می‌شود. اگر عمل پیش‌فرض قابل جلوگیری باشد، مقدار true است، در غیر این صورت مقدار false است.

[DOMName("cancelable")]
public bool Cancelable { get; }

مقدار ویژگی

bool

CurrentTarget

برای نشان دادن Aspose.Html.Dom.Events.IEventTarget که در حال حاضر Aspose.Html.Dom.Events.IEventListeners آن پردازش می‌شوند استفاده می‌شود. این به‌ویژه در طول گرفتن و حبابی شدن مفید است.

[DOMName("currentTarget")]
[DOMNullable]
public EventTarget CurrentTarget { get; }

مقدار ویژگی

EventTarget

DefaultPrevented

اگر preventDefault() در حالی که مقدار ویژگی cancelable برابر با true است فراخوانی شده باشد، true برمی‌گرداند و در غیر این صورت false.

[DOMName("defaultPrevented")]
public bool DefaultPrevented { get; }

مقدار ویژگی

bool

EventPhase

برای نشان دادن اینکه کدام مرحله از جریان رویداد در حال حاضر در حال ارزیابی است استفاده می‌شود.

[DOMName("eventPhase")]
public ushort EventPhase { get; }

مقدار ویژگی

ushort

IsTrusted

ویژگی isTrusted باید مقداری که به آن مقداردهی اولیه شده است را برگرداند. زمانی که یک رویداد ایجاد می‌شود، این ویژگی باید به false مقداردهی اولیه شود.

[DOMName("isTrusted")]
public bool IsTrusted { get; }

مقدار ویژگی

bool

Target

برای نشان دادن Aspose.Html.Dom.Events.IEventTarget که رویداد به طور اولیه به آن ارسال شده است استفاده می‌شود.

[DOMNullable]
[DOMName("target")]
public EventTarget Target { get; }

مقدار ویژگی

EventTarget

TimeStamp

برای مشخص کردن زمان (به میلی‌ثانیه نسبت به آغاز) که رویداد ایجاد شده است استفاده می‌شود. به دلیل اینکه برخی سیستم‌ها ممکن است این اطلاعات را ارائه ندهند، مقدار timeStamp ممکن است برای تمام رویدادها در دسترس نباشد. زمانی که در دسترس نیست، مقدار 0 برگردانده خواهد شد. نمونه‌هایی از زمان آغاز شامل زمان شروع سیستم یا 0:0:0 UTC 1 ژانویه 1970 است.

[DOMName("timeStamp")]
public ulong TimeStamp { get; }

مقدار ویژگی

ulong

Type

نام رویداد (حساس به حروف بزرگ و کوچک نیست). نام باید یک نام XML باشد.

[DOMName("type")]
public string Type { get; }

مقدار ویژگی

string

متدها

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 فعلی ارسال خواهد شد. این متد می‌تواند در هر مرحله‌ای از جریان رویداد استفاده شود.

 فارسی