XML DOM createEvent() 方法
定義和用法
createEvent() 方法創建新的 Event 對象。
語法:
createEvent(eventType)
參數 | 描述 |
---|---|
eventType | 想獲取的 Event 對象的事件模塊名。 關于有效的事件類型列表,請參閱“說明”部分。 |
返回值
返回新創建的 Event 對象,具有指定的類型。
拋出
如果實現支持需要的事件類型,該方法將拋出代碼為 NOT_SUPPORTED_ERR 的 DOMException 異常。
說明
該方法將創建一種新的事件類型,該類型由參數 eventType 指定。注意,該參數的值不是要創建的事件接口的名稱,而是定義那個接口的 DOM 模塊的名稱。
下表列出了 eventType 的合法值和每個值創建的事件接口:
參數 | 事件接口 | 初始化方法 |
---|---|---|
HTMLEvents | HTMLEvent | iniEvent() |
MouseEvents | MouseEvent | iniMouseEvent() |
UIEvents | UIEvent | iniUIEvent() |
用該方法創建了 Event 對象以后,必須用上表中所示的初始化方法初始化對象。關于初始化方法的詳細信息,請參閱 Event 對象參考。
該方法實際上不是由 Document 接口定義的,而是由 DocumentEvent 接口定義的。如果一個實現支持 Event 模塊,那么 Document 對象就會實現 DocumentEvent 接口并支持該方法。