Difference between revisions of "onMapSingleClick"

From Bohemia Interactive Community
Jump to navigation Jump to search
m
m (redescriptioon, examples using { })
Line 10: Line 10:
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| Define action performed when user clicks in map.  
+
| Define action performed when user clicks in map by executing [[Code]].
  
Command receives:
+
the [[Code]] receives 3 (localised in scope) variables:
  
* _pos [[Array]] position
+
* _pos: [[Position]]. an [[Array]]
* _units [[Array]] selected units
+
* _units: [[Object#Units|Units]]. an [[Array]]
* _shift, _alt [[Boolean]] key state
+
* _shift, _alt [[Boolean]] key states
  
If click is processed, command should return [[true]].  
+
When click is processed, [[Code]] should ultimately return [[true]] back to the engine.  
  
Command is executed on every click, until Command is removed via '''onMapSingleClick''' "".|=  
+
The [[Code]] is executed on every click, until the '''Command''' is  
 +
*removed via '''onMapSingleClick''' {}, or
 +
*replaced by '''onMapSingleClick''' {SomeOtherCommand(s)}|=  
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| '''onMapSingleClick''' "command" |= Syntax
+
| '''onMapSingleClick''' {[[Code]]} |= Syntax
  
|p1= "command": [[String]] |= Parameter 1
+
|p1=[[Code]]|= Parameter 1
  
 
| [[Nothing]] |= Return value
 
| [[Nothing]] |= Return value
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
| x1 = <code>onMapSingleClick """SoldierWB"" [[createUnit]] [_pos, [[group]] [[player]]]"</code>
+
| x1 = <code>onMapSingleClick {"SoldierWB" [[createUnit]] [_pos, [[group]] [[player]]];true;}</code>
 
Creates a soldier unit at the position clicked. |= Example 1  
 
Creates a soldier unit at the position clicked. |= Example 1  
  
| x2 = <code>onMapSingleClick "_grp1 [[move]] _pos; onMapSingleClick <nowiki>{}"</nowiki></code>
+
| x2 = <code>onMapSingleClick {_grp1 [[move]] _pos; onMapSingleClick {};true;}</code>
 
Orders "_grp1" to move to position clicked. Disables further map-click actions. | = Example 2
 
Orders "_grp1" to move to position clicked. Disables further map-click actions. | = Example 2
 
|  |= See also
 
|  |= See also

Revision as of 01:22, 5 September 2007