ZVON > References > DOM2 Reference
Intro / Search / ZVON
    DOM2 reference > Events: EventTarget > dispatchEvent [Go to standard]         [Glossary]  [Help]   

dispatchEvent (method )

Owning interface and usage:  
EventTarget.dispatchEvent(evt)

Member of these other interfaces:  
none

Description:  
This method allows the dispatch of events into the implementations event model. Events dispatched in this manner will have the same capturing and bubbling behavior as events dispatched directly by the implementation. The target of the event is the EventTarget on which dispatchEvent() is called.

Parameters:  
Event evt  -  Specifies the event type, behavior, and contextual information to be used in processing the event.

Returns:  
Boolean -  The return value of dispatchEvent() indicates whether any of the listeners which handled the event called preventDefault(). If preventDefault() was called the value is false, else the value is true.

Exceptions:  
EventException UNSPECIFIED_EVENT_TYPE_ERR
Raised if the Event's type was not specified by initializing the event before dispatchEvent() was called. Specification of the Event's type as null or an empty string will also trigger this exception.