org.w3c.dom.events

Interface DocumentEvent

Known Implementing Classes:
DomAttr, DomCDATA, DomCharacterData, DomComment, DomDoctype, DomDocument, DomElement, DomEntity, DomEntityReference, DomExtern, DomFragment, DomNode, DomNotation, DomNsNode, DomPI, DomText

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:
DOM Level 2

Method Summary

Event
createEvent(String eventType)

Method Details

createEvent

public Event createEvent(String eventType)
            throws DOMException

Parameters:
eventType - The eventType parameter specifies the type of Event interface to be created. If the Event interface specified is supported by the implementation this method will return a new Event of the interface type requested. If the Event is to be dispatched via the dispatchEvent method the appropriate event init method must be called after creation in order to initialize the Event's values. As an example, a user wishing to synthesize some kind of UIEvent would call createEvent with the parameter "UIEvents". The initUIEvent method could then be called on the newly created UIEvent to set the specific type of UIEvent to be dispatched and set its context information.The createEvent method is used in creating Events when it is either inconvenient or unnecessary for the user to create an Event themselves. In cases where the implementation provided Event is insufficient, users may supply their own Event implementations for use with the dispatchEvent method.

Returns:
The newly created Event

Throws:
DOMException - NOT_SUPPORTED_ERR: Raised if the implementation does not support the type of Event interface requested