Interface DocumentEvent
public interface DocumentEvent
The
DocumentEvent interface provides a mechanism by which the
user can create an Event of a type supported by the implementation. It is
expected that the DocumentEvent interface will be
implemented on the same object which implements the Document
interface in an implementation which supports the Event model.
See also the Document Object Model (DOM) Level 2 Events Specification.
- Since:
- 1.5, DOM Level 2
-
Method Summary
-
Method Details
-
createEvent
- Parameters:
eventType- TheeventTypeparameter specifies the type ofEventinterface to be created. If theEventinterface specified is supported by the implementation this method will return a newEventof the interface type requested. If theEventis to be dispatched via thedispatchEventmethod the appropriate event init method must be called after creation in order to initialize theEvent's values. As an example, a user wishing to synthesize some kind ofUIEventwould callcreateEventwith the parameter "UIEvents". TheinitUIEventmethod could then be called on the newly createdUIEventto set the specific type of UIEvent to be dispatched and set its context information.ThecreateEventmethod is used in creatingEvents when it is either inconvenient or unnecessary for the user to create anEventthemselves. In cases where the implementation providedEventis insufficient, users may supply their ownEventimplementations for use with thedispatchEventmethod.- Returns:
- The newly created
Event - Throws:
DOMException- NOT_SUPPORTED_ERR: Raised if the implementation does not support the type ofEventinterface requested
-