DocumentEvent
インターフェイスは、実装にサポートされている型のイベントをユーザが作成できるメカニズムを提供する。イベントモデルをサポートする実装において、Document
インターフェイスを実装するオブジェクトと同じオブジェクト上に、 DocumentEvent
インターフェイスが実装されていることが期待される。
createEvent
( eventType )
eventType
パラメータは作成する Event
インターフェイスの型を指定する。指定された Event
インターフェイスが実装によってサポートされている場合は、このメソッドは要求されたインターフェイス型の新しい Event
を返す。 Event
が dispachEvent
メソッド経由で送信されている場合は、 Event
の値の初期化のために、作成後に適切なイベント初期化メソッドが呼ばれなければならない。例として、ある種の UIEvent
を合成したいユーザは、パラメータ "UIEvents" をとる createEvent
を呼ぶ。送信される特定の型の UIEvent の設定、そして文脈情報の設定のために、新しく作成された UIEvent
上で initUIEvent
メソッドを呼ぶこともできる。ユーザにとってイベントの作成が不便であり、また不必要であるとき createEvent
メソッドは Event
の作成に使用される。 Event
を提供する実装が不十分な場合は、ユーザは dispatchEvent
メソッドに伴って使用するために、彼ら自身の Event
の実装を供給してもよい。
Event
interface
requested// Introduced in DOM Level 2: interface DocumentEvent { Event createEvent(in DOMString eventType) raises(DOMException); };