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.DispatchEvent(Aspose.Html.Dom.Events.Event) が呼び出された Aspose.Html.Dom.EventTarget です。

例外

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 を示すパラメーターです。

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 を示すパラメーターです。

useCapture bool

削除されるイベントリスナーがキャプチャリスナーとして登録されていたかどうかを指定します。
リスナーが二度登録されている場合、1つはキャプチャとして、もう1つはキャプチャなしで、各々を個別に削除する必要があります。
キャプチャリスナーを削除しても、同じリスナーの非キャプチャバージョンには影響しませんし、その逆も同様です。