org.w3c.dom.events
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:
- DOM Level 2
createEvent
public Event createEvent(java.lang.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
Event
s 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
Copyright
© 2003 W3C®
(MIT, ERCIM,
Keio), All Rights Reserved.
W3C liability,
trademark,
document
use and software
licensing rules apply. Your interactions with this site are in
accordance with our public
and Member
privacy statements.