EventDispatcher

Supported platforms: android, ios, mac, pc
Available since: Gideros 2011.6

Description

All classes that dispatch events inherit from `EventDispatcher`. The target of an event is a listener function and an optional data value.
When an event is dispatched, the registered function is called.
If the optional data value is given, it is used as a first parameter while calling the listener function.
Event dispatching and event targets are the core part of the Gideros event model. Different event types (such as `Event.ENTER_FRAME`, `Event.TOUCHES_BEGIN` or `Event.MOUSE_DOWN`) flow through the scene tree hierarchy differently. When a touch or mouse event occurs, Gideros dispatches an event object into the event flow from the root of the scene tree.
On the other hand, `Event.ENTER_FRAME` event is dispatched to all `Sprite` objects.

If you want to define a class that dispatches events, you can inherit your class from `EventDispatcher`.
{|- | style="width: 50%;"|

Methods

EventDispatcher.new - creates a new EventDispatcher object
EventDispatcher:addEventListener - registers a listener function
EventDispatcher:dispatchEvent - dispatches an event
EventDispatcher:hasEventListener - checks if the EventDispatcher object has a event listener
EventDispatcher:removeAllListeners - remove all listeners
EventDispatcher:removeEventListener - removes a listener function
| style="width: 50%;"|

Events

Event.APPLICATION_BACKGROUND
Event.APPLICATION_EXIT
Event.APPLICATION_FOREGROUND
Event.APPLICATION_RESIZE
Event.APPLICATION_RESUME
Event.APPLICATION_START
Event.APPLICATION_SUSPEND
Event.MEMORY_WARNING
Event.OPEN_URL

Constants

|}