| Introduced in: | DOM 2 Events |
| Modified in: | DOM 3 Events |
The DocumentEvent interface provides a mechanism by which the user can
create an Event object of a type supported by the implementation. If
the feature "Events" is supported by the Document object, the
DocumentEvent interface must be implemented on the same object. If the
feature "+Events" is supported by the Document object, an object that
supports the DocumentEvent interface must be returned by invoking the
method Node.getFeature("+Events", "3.0") on the Document object.
public function canDispatch(namespaceURI:DOMString, type:DOMString):Boolean| Introduced in: | DOM 3 Events |
Tests if the implementation can generate events of a specified type.
Parameters
| namespaceURI:DOMString — Specifies the Event.namespaceURI of the event.
|
| |
| type:DOMString — Specifies the Event.type of the event.
|
Returns | Boolean — If the implementation can generate and dispatch this event type
|
See also
public function createEvent(eventType:DOMString):Event| Introduced in: | DOM 2 Events |
Creates an event object of the type specified.
Parameters
| eventType:DOMString — The eventType parameter specifies the name of the
DOM Events interface to be supported by the created event object,
e.g. "Event", "MouseEvent", "MutationEvent" and so on. If the Event
is to be dispatched via the EventTarget.dispatchEvent() method the
appropriate event initialization 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
invoke DocumentEvent.createEvent("UIEvent"). The UIEvent.initUIEventNS()
ethod could then be called on the newly created UIEvent object to
set the specific type of user interface event to be dispatched, DOMActivate
for example, and set its context information, e.g. UIEvent.detail in
this example.
For backward compatibility reason, "UIEvents", "MouseEvents", "MutationEvents",
and "HTMLEvents" feature names are valid values for the parameter eventType
and represent respectively the interfaces "UIEvent", "MouseEvent",
"MutationEvent", and "Event", and the characters 'a'..'z' are considered
equivalent to the characters 'A'..'Z'.
|
Returns | Event — The newly created event object.
|
Throws | DOMException — NOT_SUPPORTED_ERR: Raised if the
implementation does not support the Event interface requested.
|
See also
Mon Aug 17 2009, 10:08 AM -04:00 