Difference between revisions of "onMapSingleClick"
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]]. |
| − | + | the [[Code]] receives 3 (localised in scope) variables: | |
| − | * _pos [[Array]] | + | * _pos: [[Position]]. an [[Array]] |
| − | * _units [[Array]] | + | * _units: [[Object#Units|Units]]. an [[Array]] |
| − | * _shift, _alt [[Boolean]] key | + | * _shift, _alt [[Boolean]] key states |
| − | + | When click is processed, [[Code]] should ultimately return [[true]] back to the engine. | |
| − | + | The [[Code]] is executed on every click, until the '''Command''' is | |
| + | *removed via '''onMapSingleClick''' {}, or | ||
| + | *replaced by '''onMapSingleClick''' {SomeOtherCommand(s)}|= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| − | | '''onMapSingleClick''' | + | | '''onMapSingleClick''' {[[Code]]} |= Syntax |
| − | |p1= | + | |p1=[[Code]]: |= Parameter 1 |
| [[Nothing]] |= Return value | | [[Nothing]] |= Return value | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| − | | x1 = <code>onMapSingleClick | + | | 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 | + | | 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 | ||
