Interface IEventTarget

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

Giao diện Aspose.Html.Dom.EventTarget được triển khai bởi tất cả các Node trong một triển khai hỗ trợ Mô hình Sự kiện DOM.
Do đó, giao diện này có thể được lấy bằng cách sử dụng các phương thức ép kiểu cụ thể cho liên kết trên một thể hiện của giao diện Node.
Giao diện cho phép đăng ký và xóa các Event Listener trên một Aspose.Html.Dom.EventTarget và phát sự kiện đến Aspose.Html.Dom.Events.IEventTarget đó.

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

Phương thức

AddEventListener(string, IEventListener)

Phương thức này cho phép đăng ký các listener sự kiện trên mục tiêu sự kiện.

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

Tham số

type string

Loại sự kiện mà người dùng đang đăng ký

listener IEventListener

Nhận một giao diện được triển khai bởi người dùng, chứa các phương thức sẽ được gọi khi sự kiện xảy ra.

Nhận xét

Nếu một Aspose.Html.Dom.Events.IEventListener được thêm vào một Aspose.Html.Dom.EventTarget trong khi nó đang xử lý một sự kiện, nó sẽ không được kích hoạt bởi các hành động hiện tại nhưng có thể được kích hoạt trong một giai đoạn sau của luồng sự kiện, chẳng hạn như giai đoạn bubbling.

Nếu nhiều Event Listener giống hệt nhau được đăng ký trên cùng một Aspose.Html.Dom.EventTarget với cùng các tham số, các thể hiện trùng lặp sẽ bị loại bỏ. Chúng sẽ không gây ra việc gọi Aspose.Html.Dom.Events.IEventListener hai lần và vì chúng bị loại bỏ nên không cần phải xóa bằng phương thức Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).

AddEventListener(string, IEventListener, bool)

Phương thức này cho phép đăng ký các listener sự kiện trên mục tiêu sự kiện.

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

Tham số

type string

Loại sự kiện mà người dùng đang đăng ký

listener IEventListener

Nhận một giao diện được triển khai bởi người dùng, chứa các phương thức sẽ được gọi khi sự kiện xảy ra.

useCapture bool

Nếu true, useCapture chỉ ra rằng người dùng muốn bắt đầu việc bắt giữ.
Sau khi bắt đầu việc bắt giữ, tất cả các sự kiện của loại đã chỉ định sẽ được phát đến Aspose.Html.Dom.Events.IEventListener đã đăng ký trước khi được phát đến bất kỳ Event Targets nào bên dưới chúng trong cây.
Các sự kiện đang bubbling lên qua cây sẽ không kích hoạt một Aspose.Html.Dom.Events.IEventListener được chỉ định để sử dụng việc bắt giữ.

Nhận xét

Nếu một Aspose.Html.Dom.Events.IEventListener được thêm vào một Aspose.Html.Dom.EventTarget trong khi nó đang xử lý một sự kiện, nó sẽ không được kích hoạt bởi các hành động hiện tại nhưng có thể được kích hoạt trong một giai đoạn sau của luồng sự kiện, chẳng hạn như giai đoạn bubbling.

Nếu nhiều Event Listener giống hệt nhau được đăng ký trên cùng một Aspose.Html.Dom.EventTarget với cùng các tham số, các thể hiện trùng lặp sẽ bị loại bỏ. Chúng sẽ không gây ra việc gọi Aspose.Html.Dom.Events.IEventListener hai lần và vì chúng bị loại bỏ nên không cần phải xóa bằng phương thức Aspose.Html.Dom.Events.IEventTarget.RemoveEventListener(System.String,Aspose.Html.Dom.Events.IEventListener).

DispatchEvent(Event)

Phương thức này cho phép phát các sự kiện vào mô hình sự kiện của các triển khai.

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

Tham số

event Event

Chỉ định loại sự kiện, hành vi và thông tin ngữ cảnh sẽ được sử dụng trong việc xử lý sự kiện.

Trả về

bool

Giá trị trả về của Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) cho biết liệu bất kỳ listener nào đã xử lý sự kiện có gọi Aspose.Html.Dom.Events.Event.PreventDefault hay không.
Nếu Aspose.Html.Dom.Events.Event.PreventDefault được gọi, giá trị là false, ngược lại giá trị là true.

Nhận xét

Các sự kiện được phát theo cách này sẽ có hành vi bắt giữ và bubbling giống như các sự kiện được phát trực tiếp bởi triển khai.
Mục tiêu của sự kiện là Aspose.Html.Dom.EventTarget trên đó Aspose.Html.Dom.EventTarget.DispatchEvent(Aspose.Html.Dom.Events.Event) được gọi.

Ngoại lệ

DOMException

RemoveEventListener(string, IEventListener)

Phương thức này cho phép xóa các listener sự kiện khỏi mục tiêu sự kiện.
Nếu một Aspose.Html.Dom.Events.IEventListener bị xóa khỏi một Aspose.Html.Dom.EventTarget trong khi nó đang xử lý một sự kiện, nó sẽ không được kích hoạt bởi các hành động hiện tại.
Các Event Listener không bao giờ có thể được gọi sau khi bị xóa.

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

Tham số

type string

Chỉ định loại sự kiện của Aspose.Html.Dom.Events.IEventListener đang bị xóa.

listener IEventListener

Tham số Aspose.Html.Dom.Events.IEventListener chỉ định Aspose.Html.Dom.Events.IEventListener sẽ bị xóa.

RemoveEventListener(string, IEventListener, bool)

Phương thức này cho phép xóa các listener sự kiện khỏi mục tiêu sự kiện.
Nếu một Aspose.Html.Dom.Events.IEventListener bị xóa khỏi một Aspose.Html.Dom.EventTarget trong khi nó đang xử lý một sự kiện, nó sẽ không được kích hoạt bởi các hành động hiện tại.
Các Event Listener không bao giờ có thể được gọi sau khi bị xóa.

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

Tham số

type string

Chỉ định loại sự kiện của Aspose.Html.Dom.Events.IEventListener đang bị xóa.

listener IEventListener

Tham số Aspose.Html.Dom.Events.IEventListener chỉ định Aspose.Html.Dom.Events.IEventListener sẽ bị xóa.

useCapture bool

Chỉ định liệu EventListener đang bị xóa có được đăng ký như một listener bắt giữ hay không.
Nếu một listener được đăng ký hai lần, một lần với việc bắt giữ và một lần không, mỗi cái phải được xóa riêng biệt.
Việc xóa một listener bắt giữ không ảnh hưởng đến phiên bản không bắt giữ của cùng một listener và ngược lại.