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

public interface DocumentEvent

DocumentEvent インタフェースは、実装によってサポートされる型のイベントを作成できる機構を提供します。イベントモデルをサポートする実装では、DocumentEvent インタフェースは Document インタフェースを実装するオブジェクトと同じオブジェクト上に実装されることが予想されます。

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

導入されたバージョン:

DOM Level 2

メソッドの概要

Event

createEvent(String eventType)

メソッドの詳細

createEvent

Event createEvent(String eventType)
                  throws DOMException

パラメータ:

eventType - eventType パラメータは、作成する Event インタフェースの型を指定する。指定された Event インタフェースが実装によってサポートされる場合、このメソッドは、要求されるインタフェースの型の新しい Event を返す。dispatchEvent メソッドを介して Event がディスパッチされる場合、Event の値を初期化するために、イベントの作成後に適切なイベント init メソッドを呼び出す必要がある。たとえば、ある種の UIEvent を合成するときは、「UIEvents」パラメータで createEvent を呼び出す。これにより、新しく作成される UIEvent に対して initUIEvent メソッドを呼び出して、ディスパッチする特定の型の UIEvent とそのコンテキスト情報を設定できる。Event を独自で作成することが困難、または不必要な場合は、createEvent メソッドを使用して Event を作成する。Event を提供した実装が不十分な場合、ユーザは、dispatchEvent メソッドで使用する独自の Event 実装を指定できる

戻り値:

新しく作成された Event

例外:

DOMException - NOT_SUPPORTED_ERR: 実装が要求された Event インタフェースの型をサポートしない場合