Difference between revisions of "Event.TOUCHES CANCEL"

From GiderosMobile
 
(10 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
'''Available since:''' Gideros 2011.6<br/>
 
'''Available since:''' Gideros 2011.6<br/>
 
'''Value:''' touchesCancel<br/>
 
'''Value:''' touchesCancel<br/>
 +
'''Defined by:''' [[Sprite]]<br/>
 +
 
=== Description ===
 
=== Description ===
This event is dispatched when touch is interrupted, for example, by a phone call, or any sort of modal dialog.
+
This event is dispatched when touch is interrupted, for example, by a phone call, or any sort of modal dialog. This event is dispatched only on devices.
This event is dispatched only on devices.
 
  
 
Modifiers can have values of:
 
Modifiers can have values of:
`KeyCode.MODIFIER_NONE`
+
*'''KeyCode.MODIFIER_NONE''', '''0'''
`KeyCode.MODIFIER_SHIFT`
+
*'''KeyCode.MODIFIER_SHIFT''', '''1'''
`KeyCode.MODIFIER_CTRL`
+
*'''KeyCode.MODIFIER_ALT''', '''2''' (LEFT)
`KeyCode.MODIFIER_ALT`
+
*'''KeyCode.MODIFIER_CTRL''', '''4'''
`KeyCode.MODIFIER_META`
+
*'''KeyCode.MODIFIER_ALT''', '''6''' (RIGHT, Alt Gr)
 +
*'''KeyCode.MODIFIER_META''', '''8'''
 +
 
 
=== Parameters ===
 
=== Parameters ===
 
'''touch.x''': (number) x coordinate of the current touch<br/>
 
'''touch.x''': (number) x coordinate of the current touch<br/>
Line 18: Line 21:
 
'''touch.ry''': (number) unrounded y coordinate of the touch<br/>
 
'''touch.ry''': (number) unrounded y coordinate of the touch<br/>
 
'''touch.id''': (number) the id of current touch. This number is 1 if this is a first touch, 2 if it is a second, etc.<br/>
 
'''touch.id''': (number) the id of current touch. This number is 1 if this is a first touch, 2 if it is a second, etc.<br/>
'''touch.type''': (string) Input type, possible values: finger, pen, mouse, penTablet<br/>
+
'''touch.type''': (string) input type, possible values: finger, pen, mouse, penTablet<br/>
'''touch.pressure''': (number) Pressure on screen, 0 if not able to detect<br/>
+
'''touch.pressure''': (number) pressure on screen, 0 if not able to detect<br/>
'''touch.mouseButton''': (number) Mouse button which triggered this event, if any<br/>
+
'''touch.mouseButton''': (number) mouse button which triggered this event, if any<br/>
'''touch.modifiers''': (number) Modifiers present<br/>
+
'''touch.modifiers''': (number) modifiers present<br/>
'''allTouches''': (table) lua table containing previously described touch table with x, y, rx, ry and id properties for all touches that are currently on device.<br/>
+
'''allTouches''': (table) lua table containing previously described touch table with x, y, rx, ry and id properties for all touches that are currently on device<br/>
 +
 
 +
{{Sprite}}

Latest revision as of 05:26, 1 August 2025

Available since: Gideros 2011.6
Value: touchesCancel
Defined by: Sprite

Description

This event is dispatched when touch is interrupted, for example, by a phone call, or any sort of modal dialog. This event is dispatched only on devices.

Modifiers can have values of:

  • KeyCode.MODIFIER_NONE, 0
  • KeyCode.MODIFIER_SHIFT, 1
  • KeyCode.MODIFIER_ALT, 2 (LEFT)
  • KeyCode.MODIFIER_CTRL, 4
  • KeyCode.MODIFIER_ALT, 6 (RIGHT, Alt Gr)
  • KeyCode.MODIFIER_META, 8

Parameters

touch.x: (number) x coordinate of the current touch
touch.y: (number) y coordinate of the current touch
touch.rx: (number) unrounded x coordinate of the touch
touch.ry: (number) unrounded y coordinate of the touch
touch.id: (number) the id of current touch. This number is 1 if this is a first touch, 2 if it is a second, etc.
touch.type: (string) input type, possible values: finger, pen, mouse, penTablet
touch.pressure: (number) pressure on screen, 0 if not able to detect
touch.mouseButton: (number) mouse button which triggered this event, if any
touch.modifiers: (number) modifiers present
allTouches: (table) lua table containing previously described touch table with x, y, rx, ry and id properties for all touches that are currently on device