-
public interface DocumentEventTheDocumentEventinterface provides a mechanism by which the user can create an Event of a type supported by the implementation. It is expected that theDocumentEventinterface will be implemented on the same object which implements theDocumentinterface 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
All Methods Instance Methods Abstract Methods Modifier and Type Method Description EventcreateEvent(String eventType)
-
-
-
Method Detail
-
createEvent
Event createEvent(String eventType) throws DOMException
- 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
-
-