|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
public interface EventTarget
EventTarget
インタフェースは、DOM イベントモデルをサポートする実装では、すべての Node
によって実装されます。そのため、Node
インタフェースのインスタンスでバインディングに特有のキャストメソッドを使用して、このインタフェースを取得できます。このインタフェースでは、EventTarget
で EventListeners
を登録、削除したり、EventTarget
にイベントをディスパッチしたりできます。
「Document Object Model (DOM) Level 2 Events Specification」も参照してください。
メソッドの概要 | |
---|---|
void |
addEventListener(String type,
EventListener listener,
boolean useCapture)
このメソッドでは、イベントターゲットにイベントリスナーを登録できます。 |
boolean |
dispatchEvent(Event evt)
このメソッドでは、実装イベントモデルにイベントをディスパッチできます。 |
void |
removeEventListener(String type,
EventListener listener,
boolean useCapture)
このメソッドでは、イベントターゲットからイベントリスナーを削除できます。 |
メソッドの詳細 |
---|
void addEventListener(String type, EventListener listener, boolean useCapture)
EventTarget
に EventListener
を追加した場合、現在のアクションではトリガーされませんが、バブルフェーズなど、イベントフローのあとの段階ではトリガーされる場合があります。EventListener
が同じパラメータを持って同じ EventTarget
に登録されている場合は、重複するインスタンスが破棄されます。これによって、EventListener
が 2度呼び出されることはありません。 重複するインスタンスは破棄されるため、removeEventListener
メソッドで削除する必要はありません。
type
- ユーザーが登録しているイベントの型listener
- listener
パラメータは、イベントの発生時に呼び出されるメソッドを含み、
ユーザーによって実装されるインタフェースを
指定するuseCapture
- true の場合、ユーザーがキャプチャーを開始したいことを
useCapture
が示す。指定された型のすべてのイベントは、
キャプチャーを開始したあと、ツリーの下部にある
EventTargets
にディスパッチされる前に、登録された
EventListener
にディスパッチされる。ツリーを介して
上方へ向かってバブルしているイベントは、
キャプチャーに使用するために指定した EventListener
をトリガーしないvoid removeEventListener(String type, EventListener listener, boolean useCapture)
EventTarget
から EventListener
を削除する場合、現在のアクションではトリガーされません。EventListener
は削除されたあとには呼び出しできません。EventTarget
に登録されている EventListener
を識別しない引数で removeEventListener
を呼び出しても、効果はまったくありません。
type
- 削除される EventListener
のイベントの型を
指定するlistener
- EventListener
パラメータは削除される
EventListener
を示すuseCapture
- 削除される EventListener
がキャプチャーするリスナーとして
登録されたかどうかを指定する。リスナーが
キャプチャーする場合としない場合の 2 回登録された場合は、
別々に削除する必要がある。キャプチャーするリスナーを削除しても、
同じリスナーでキャプチャーしないバージョンにはまったく影響しない。
逆の場合も同様boolean dispatchEvent(Event evt) throws EventException
dispatchEvent
が呼び出される EventTarget
です。
evt
- イベント処理中に使用されるイベントの型、
動作、およびコンテキスト情報を指定する
dispatchEvent
の戻り値は、
イベントを処理したリスナーが preventDefault
を呼び出したかどうかを示す。preventDefault
が呼び出された場合の値は false。そうでない場合の値は true
EventException
- UNSPECIFIED_EVENT_TYPE_ERR:dispatchEvent
が呼び出される前に
イベントを初期化して Event
の型が
指定されなかった場合。Event
の型を
null
または空の文字列に指定しても、
この例外がトリガーされる
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。