Difference between revisions of "Event"

From GiderosMobile
m
 
(2 intermediate revisions by one other user not shown)
Line 14: Line 14:
 
=== Examples ===
 
=== Examples ===
 
'''Mouse down event example'''
 
'''Mouse down event example'''
<source lang="lua">
+
<syntaxhighlight lang="lua">
 
function onMouseDown(event)
 
function onMouseDown(event)
 
   print(event.x, event.y)
 
   print(event.x, event.y)
Line 20: Line 20:
  
 
mysprite:addEventListener(Event.MOUSE_DOWN, onMouseDown)
 
mysprite:addEventListener(Event.MOUSE_DOWN, onMouseDown)
</source>
+
</syntaxhighlight>
  
 
'''User created event'''
 
'''User created event'''
<source lang="lua">
+
<syntaxhighlight lang="lua">
 
local event = Event.new("myevent")
 
local event = Event.new("myevent")
 
event.data1 = "12345"
 
event.data1 = "12345"
 
event.data2 = "abcde"
 
event.data2 = "abcde"
 
mydispatcher:dispatchEvent(event)
 
mydispatcher:dispatchEvent(event)
</source>
+
</syntaxhighlight>
  
 
=== Note ===
 
=== Note ===
Please note that most events happen on the '''[[Sprite]]''' class.
+
Please note that most events happen in the '''[[Sprite]]''' class.
  
 
{|-
 
{|-

Latest revision as of 19:16, 15 December 2023

Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
Available since: Gideros 2011.6
Inherits from: Object

Description

The objects of Event class contain information about an event that has occurred. Event objects are passed to event listeners when an event occurs.

Usually event objects contain specific additional information about the event that has occured. For example, when an Event.MOUSE_DOWN event occurs, x and y fields contain the coordinates.

Users can create their own events and dispatch through the event mechanism.

Examples

Mouse down event example

function onMouseDown(event)
  print(event.x, event.y)
end

mysprite:addEventListener(Event.MOUSE_DOWN, onMouseDown)

User created event

local event = Event.new("myevent")
event.data1 = "12345"
event.data2 = "abcde"
mydispatcher:dispatchEvent(event)

Note

Please note that most events happen in the Sprite class.

Methods

Event.new creates a new Event object

Event:getTarget returns the element on which the event listener was registered
Event:getType returns the type of Event
Event:stopPropagation stops the propagation of the current event in the scene tree hierarchy

Events

Constants