public interface DocumentEvent
DocumentEventインタフェースは、実装によってサポートされる型のイベントを作成できるメカニズムを提供します。 イベント・モデルをサポートする実装では、DocumentEventインタフェースはDocumentインタフェースを実装するオブジェクトと同じオブジェクト上に実装されることが予想されます。
「Document Object Model (DOM) Level 2 Events Specification」も参照してください。
- 導入されたバージョン:
- 1.5、DOMレベル2
-
メソッドのサマリー
-
メソッドの詳細
-
createEvent
- パラメータ:
eventType-eventTypeパラメータは、作成されるEventインタフェースの型を指定する。 指定されたEventインタフェースが実装によりサポートされている場合、このメソッドは、要求されたインタフェース型の新しいEventを返す。EventがdispatchEventメソッドでディスパッチされる場合は、Eventの値を初期化するために、該当するイベント初期化メソッドをイベントの作成後に呼び出さなければならない。 たとえば、ある種のUIEventを合成するためには、パラメータに「UIEvents」を指定してcreateEventを呼び出す。 これにより、新しく作成されるUIEventに対してinitUIEventメソッドを呼び出して、ディスパッチするUIEventの特定の型とそのコンテキスト情報を設定できる。Eventを独自に作成することが困難であるか不必要な場合は、createEventメソッドを使用してEventを作成する。 実装により提供されるEventでは不十分な場合に、ユーザーは、dispatchEventメソッドと一緒に使用する独自のEventの実装を提供することができる。- 戻り値:
- 新しく作成された
Event - 例外:
DOMException- NOT_SUPPORTED_ERR: 実装が、要求されたEventインタフェースの型をサポートしない場合に発生します。
-