dispatchEvent method
The dispatchEvent()
method of the EventTarget sends an Event to
the object, (synchronously) invoking the affected
event listeners in the appropriate order. The normal event processing
rules (including the capturing and optional bubbling phase) also apply to
events
dispatched manually with dispatchEvent()
.
Calling dispatchEvent()
is the last step to firing an event. The event
should have already been created and initialized using an Event.Event
constructor.
Note: When calling this method, the Event.target property is initialized to the current
EventTarget
.
Unlike "native" events, which are fired by the browser and invoke event
handlers
asynchronously via the
event loop,
dispatchEvent()
invokes event handlers synchronously. All applicable
event
handlers are called and return before dispatchEvent()
returns.
Implementation
external bool dispatchEvent(Event event);