Difference between revisions of "EventDispatcher"
m (put some space between methods) |
|||
(4 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
− | |||
<!-- GIDEROSOBJ:EventDispatcher --> | <!-- GIDEROSOBJ:EventDispatcher --> | ||
− | ''' | + | '''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]][[File:Platform html5.png]][[File:Platform winrt.png]][[File:Platform win32.png]]<br/> |
− | ''' | + | '''Available since:''' Gideros 2011.6<br/> |
− | ''' | + | '''Inherits from:''' [[Object]]<br/> |
− | === | + | === Description === |
− | All classes that dispatch events inherit from | + | 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. | + | 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. | |
− | + | === Examples === | |
+ | '''User created event''' | ||
+ | <syntaxhighlight lang="lua"> | ||
+ | local event = Event.new("myevent") | ||
+ | event.data1 = "12345" | ||
+ | event.data2 = "abcde" | ||
+ | mydispatcher:dispatchEvent(event) | ||
+ | </syntaxhighlight> | ||
− | === | + | '''Game loop''' |
− | < | + | <syntaxhighlight lang="lua"> |
− | + | Ball = Core.class(Sprite) | |
+ | |||
+ | function Ball:onEnterFrame() | ||
+ | self:setX(self:getX() + 1) | ||
+ | end | ||
+ | |||
+ | ball = Ball.new() | ||
+ | ball:addEventListener(Event.ENTER_FRAME, ball.onEnterFrame, ball) | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | '''EventDispatcher inheritance''' | ||
+ | <syntaxhighlight lang="lua"> | ||
ClassA = Core.class(EventDispatcher) | ClassA = Core.class(EventDispatcher) | ||
ClassB = Core.class(EventDispatcher) | ClassB = Core.class(EventDispatcher) | ||
Line 36: | Line 53: | ||
b:dispatchEvent(Event.new("myevent")) -- will print "funcA" | b:dispatchEvent(Event.new("myevent")) -- will print "funcA" | ||
− | + | </syntaxhighlight> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | </ | ||
{|- | {|- | ||
| style="width: 50%; vertical-align:top;"| | | style="width: 50%; vertical-align:top;"| | ||
− | === | + | === Methods === |
− | [[ | + | [[EventDispatcher.new]] ''creates a new EventDispatcher object''<br/><!--GIDEROSMTD:EventDispatcher.new() creates a new EventDispatcher object--> |
− | <!-- GIDEROSMTD:EventDispatcher.new() creates a new EventDispatcher object --> | ||
− | [[ | + | [[EventDispatcher:addEventListener]] ''registers a listener function''<br/><!--GIDEROSMTD:EventDispatcher:addEventListener(type,listener,data) registers a listener function--> |
− | <!-- GIDEROSMTD:EventDispatcher:addEventListener(type,listener,data) registers a listener function --> | + | [[EventDispatcher:dispatchEvent]] ''dispatches an event''<br/><!--GIDEROSMTD:EventDispatcher:dispatchEvent(event) dispatches an event--> |
− | [[ | + | [[EventDispatcher:hasEventListener]] ''checks if the EventDispatcher object has a event listener''<br/><!--GIDEROSMTD:EventDispatcher:hasEventListener(type) checks if the EventDispatcher object has a event listener--> |
− | <!-- GIDEROSMTD:EventDispatcher:dispatchEvent(event) dispatches an event --> | + | [[EventDispatcher:removeAllListeners]] ''remove all listeners''<br/><!--GIDEROSMTD:EventDispatcher:removeAllListeners() remove all listeners--> |
− | [[ | + | [[EventDispatcher:removeEventListener]] ''removes a listener function''<br/><!--GIDEROSMTD:EventDispatcher:removeEventListener(type,listener,data) removes a listener function--> |
− | <!-- GIDEROSMTD:EventDispatcher:hasEventListener(type) checks if the EventDispatcher object has a event listener --> | ||
− | [[ | ||
− | <!-- GIDEROSMTD:EventDispatcher:removeAllListeners() remove all listeners --> | ||
− | [[ | ||
− | <!-- GIDEROSMTD:EventDispatcher:removeEventListener(type,listener,data) removes a listener function --> | ||
| style="width: 50%; vertical-align:top;"| | | style="width: 50%; vertical-align:top;"| | ||
− | === | + | === Events === |
− | [[ | + | [[Event.APPLICATION_BACKGROUND]]<br/><!--GIDEROSEVT:Event.APPLICATION_BACKGROUND applicationBackground--> |
− | <!-- GIDEROSEVT:Event.APPLICATION_BACKGROUND applicationBackground--> | + | [[Event.APPLICATION_EXIT]]<br/><!--GIDEROSEVT:Event.APPLICATION_EXIT applicationExit--> |
− | [[ | + | [[Event.APPLICATION_FOREGROUND]]<br/><!--GIDEROSEVT:Event.APPLICATION_FOREGROUND applicationForeground--> |
− | <!-- GIDEROSEVT:Event.APPLICATION_EXIT applicationExit--> | + | [[Event.APPLICATION_RESIZE]]<br/><!--GIDEROSEVT:Event.APPLICATION_RESIZE applicationResize--> |
− | [[ | + | [[Event.APPLICATION_RESUME]]<br/><!--GIDEROSEVT:Event.APPLICATION_RESUME applicationResume--> |
− | <!-- GIDEROSEVT:Event.APPLICATION_FOREGROUND applicationForeground--> | + | [[Event.APPLICATION_START]]<br/><!--GIDEROSEVT:Event.APPLICATION_START applicationStart--> |
− | [[ | + | [[Event.APPLICATION_SUSPEND]]<br/><!--GIDEROSEVT:Event.APPLICATION_SUSPEND applicationSuspend--> |
− | <!-- GIDEROSEVT:Event.APPLICATION_RESIZE applicationResize--> | + | [[Event.MEMORY_WARNING]]<br/><!--GIDEROSEVT:Event.MEMORY_WARNING memoryWarning--> |
− | [[ | + | [[Event.OPEN_URL]]<br/><!--GIDEROSEVT:Event.OPEN_URL openUrl--> |
− | <!-- GIDEROSEVT:Event.APPLICATION_RESUME applicationResume--> | + | === Constants === |
− | [[ | ||
− | <!-- GIDEROSEVT:Event.APPLICATION_START applicationStart--> | ||
− | [[ | ||
− | <!-- GIDEROSEVT:Event.APPLICATION_SUSPEND applicationSuspend--> | ||
− | [[ | ||
− | <!-- GIDEROSEVT:Event.MEMORY_WARNING memoryWarning--> | ||
− | [[ | ||
− | <!-- GIDEROSEVT:Event.OPEN_URL openUrl--> | ||
− | === | ||
|} | |} | ||
+ | |||
+ | {{GIDEROS IMPORTANT LINKS}} |
Latest revision as of 01:26, 18 November 2023
Supported platforms:
Available since: Gideros 2011.6
Inherits from: Object
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.
Examples
User created event
local event = Event.new("myevent")
event.data1 = "12345"
event.data2 = "abcde"
mydispatcher:dispatchEvent(event)
Game loop
Ball = Core.class(Sprite)
function Ball:onEnterFrame()
self:setX(self:getX() + 1)
end
ball = Ball.new()
ball:addEventListener(Event.ENTER_FRAME, ball.onEnterFrame, ball)
EventDispatcher inheritance
ClassA = Core.class(EventDispatcher)
ClassB = Core.class(EventDispatcher)
function ClassA:funcA(event)
print("funcA", self, event:getType(), event:getTarget())
end
local a = ClassA.new()
local b = ClassB.new()
b:addEventListener("myevent", a.funcA, a)
-- when b dispatches an "myevent" event, a.funcA will be called with 'a' as first parameter
b:dispatchEvent(Event.new("myevent")) -- will print "funcA"
MethodsEventDispatcher.new creates a new EventDispatcher object EventDispatcher:addEventListener registers a listener function |
EventsEvent.APPLICATION_BACKGROUND Constants |