setAllStates: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Updated with recent version changes.)
No edit summary
Line 12: Line 12:
<source lang="mtmacro" line>
<source lang="mtmacro" line>
setAllStates(value, id)
setAllStates(value, id)
</source>
<source lang="mtmacro" line>
setAllStates(value, id, mapname)
</source>
</source>
'''Parameter'''
'''Parameter'''
{{param|value|If all states should be set on or off, {{true}} or {{false}}.}}
{{param|value|If all states should be set on or off, {{true}} or {{false}}.}}
{{param|id|The token {{code|id}} of the token that should have its [[State|States]] set, defaults to the [[Current Token]]. {{TrustedParameter}} }}
{{param|id|The token {{code|id}} of the token that should have its [[State|States]] set, defaults to the [[Current Token]]. {{TrustedParameter}} }}
{{param|mapname|The name of the map where the token is, defaults to the current map.}}


|examples=
|examples=
Line 35: Line 39:
{{change|1.3b51|Added {{code|id}} parameter option.}}
{{change|1.3b51|Added {{code|id}} parameter option.}}
}}
}}
{{change|1.5.4|Added {{code|mapname}} parameter option.}}
[[Category:State Function]]
[[Category:State Function]]

Revision as of 20:17, 14 August 2019

 This article is a stub, you can help the RPTools Wiki project by contributing content to expand this article.
 This article needs: Examples using new functionality.

setAllSates() Function

Introduced in version 1.3b40
Sets all of the States of a Token to on (true(1)) or off (false(0)).

Usage

setAllStates(value)
setAllStates(value, id)
setAllStates(value, id, mapname)

Parameter

  • value - If all states should be set on or off, true(1) or false(0).
  • id - The token id of the token that should have its States set, defaults to the Current Token.

     Note: This parameter can only be used in a Trusted Macro

  • mapname - The name of the map where the token is, defaults to the current map.

Examples

Set all Token States on
[h: setAllStates(1)]

Set all Token States off

[h: setAllStates(0)]

See Also

Version Changes

  • 1.3b51 - Added id parameter option.
  • 1.5.4 - Added mapname parameter option.