Common DOM API

org.w3c.dom.events
インタフェース EventTarget


public interface EventTarget

EventTarget インタフェースは、DOM イベントモデルをサポートする 実装において、すべての Nodes によって実装されます。したがって、 このインタフェースは、Node インタフェースのインスタンスに対して バインディング固有のキャストメソッドを使用することによって取得できます。この インタフェースでは、EventTarget 上の EventListeners の登録と削除、およびその EventTarget に対するイベントの ディスパッチを実行できます。

「Document Object Model (DOM) Level 2 Events Specification」も参照してください。

導入されたバージョン:
DOM Level 2

メソッドの概要
 void addEventListener(String type, EventListener listener, boolean useCapture)
          このメソッドでは、イベントターゲットにイベントリスナーを登録できます。
 boolean dispatchEvent(Event evt)
          このメソッドでは、実装のイベントモデルにイベントをディスパッチできます。
 void removeEventListener(String type, EventListener listener, boolean useCapture)
          このメソッドでは、イベントターゲットからイベントリスナーを削除できます。
 

メソッドの詳細

addEventListener

public void addEventListener(String type,
                             EventListener listener,
                             boolean useCapture)
このメソッドでは、イベントターゲットにイベントリスナーを登録できます。イベントを 処理中の EventTarget に対して EventListener を 追加した場合、そのリスナーは現在のアクションによってトリガーされませんが、 イベントフローのそのあとの段階 (バブルフェーズなど) でトリガーされる可能性が あります。
複数の同一の EventListener を同じ EventTarget に対して同じパラメータを使って登録した場合、重複するインスタンスは破棄されます。 EventListener が 2 回呼び出されることはありません。また、重複する インスタンスが破棄されるため、removeEventListener メソッドで削除する 必要もありません。

パラメータ:
type - ユーザが登録しているイベントの型
listener - listener パラメータには、ユーザによって実装された インタフェースで、イベントが発生した時点で呼び出されるメソッドを含むものを指定 する
useCapture - true の場合、useCapture はユーザがキャプチャの 開始を希望していることを示す。キャプチャを開始したあとは、指定した型のすべての イベントが、ツリー内の下位にある EventTargets にディスパッチされる より前に、登録した EventListener にディスパッチされる。ツリーに 沿って上方へバブルしているイベントは、キャプチャを使用するように指定された EventListener をトリガーすることがない

removeEventListener

public void removeEventListener(String type,
                                EventListener listener,
                                boolean useCapture)
このメソッドでは、イベントターゲットからイベントリスナーを削除できます。イベントの 処理中に EventListenerEventTarget から削除した 場合、そのリスナーは現在のアクションによってトリガーされることがありません。 EventListener は、削除されたあとは決して呼び出せません。
removeEventListener を、EventTarget に現在 登録されている EventListener を指定していない引数で呼び出しても、 何も効果はありません。

パラメータ:
type - 削除する EventListener のイベント型を指定する
listener - EventListener パラメータは、削除する EventListener を示す
useCapture - 削除する EventListener がキャプチャリスナーとして 登録されたものかどうかを指定する。リスナーを 2 回登録した場合、1 回はキャプチャ として、もう 1 回はキャプチャとしてではなく登録したのであれば、それぞれのリスナーを 別々に削除しなければならない。また、そのような場合、キャプチャリスナーを削除 しても、非キャプチャリスナーには影響が及ばない。その逆の削除でも同様である

dispatchEvent

public boolean dispatchEvent(Event evt)
                      throws EventException
このメソッドでは、実装のイベントモデルにイベントをディスパッチできます。この方法で ディスパッチされたイベントのキャプチャとバブルに関する動作は、実装により直接に ディスパッチされたイベントの場合と同じです。イベントのターゲットは、 dispatchEvent が呼び出された対象の EventTarget です。

パラメータ:
evt - イベントの処理で使用されるイベント型、動作、およびコンテキスト情報を 指定する
戻り値:
dispatchEvent の戻り値は、イベントを処理するリスナーが preventDefault を呼び出したかどうかを示す。 preventDefault が呼び出された場合の値は false、そうでない場合は true
例外:
EventException - UNSPECIFIED_EVENT_TYPE_ERR:dispatchEvent メソッドが呼び出さ れる前に、イベントの初期化によって Event の型が指定されていな かった場合に発生する。Event の型を null と指定した 場合、または空の文字列を指定した場合にも、この例外がトリガーされる

Common DOM API

バグや機能要求の報告
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.