Difference between revisions of "EventDispatcher"
Line 21: | Line 21: | ||
function ClassA:funcA(event) | function ClassA:funcA(event) | ||
− | print( | + | print("funcA", self, event:getType(), event:getTarget()) |
end | end | ||
Line 27: | Line 27: | ||
local b = ClassB.new() | local b = ClassB.new() | ||
− | b:addEventListener( | + | b:addEventListener("myevent", a.funcA, a) -- when b dispatches an "myevent" event, |
-- a.funcA will be called with 'a' | -- a.funcA will be called with 'a' | ||
-- as first parameter | -- as first parameter | ||
− | b:dispatchEvent(Event.new( | + | b:dispatchEvent(Event.new("myevent")) -- will print "funcA" |
Line 45: | Line 45: | ||
{|- | {|- | ||
| style="width: 50%; vertical-align:top;"| | | style="width: 50%; vertical-align:top;"| | ||
+ | |||
=== <translate>Methods</translate> === | === <translate>Methods</translate> === | ||
[[Special:MyLanguage/EventDispatcher.new|EventDispatcher.new]] ''<translate>creates a new EventDispatcher object</translate>''<br/><!-- GIDEROSMTD:EventDispatcher.new() creates a new EventDispatcher object --> | [[Special:MyLanguage/EventDispatcher.new|EventDispatcher.new]] ''<translate>creates a new EventDispatcher object</translate>''<br/><!-- GIDEROSMTD:EventDispatcher.new() creates a new EventDispatcher object --> |
Revision as of 11:28, 1 November 2018
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
Example
-- example 1
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"
-- example 2
Ball = Core.class(Sprite)
function Ball:onEnterFrame()
self:setX(self:getX() 1)
end
ball = Ball.new()
ball:addEventListener(Event.ENTER_FRAME, ball.onEnterFrame, ball)
MethodsEventDispatcher.new creates a new EventDispatcher object |
EventsEvent.APPLICATION_BACKGROUND Constants |