setAllStates: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 7: Line 7:


|usage=
|usage=
<source lang="mtmacro" line>
<source lang="mtmacro">
setAllStates(value)
setAllStates(value)
</source>
<source lang="mtmacro" line>
setAllStates(value, id)
setAllStates(value, id)
</source>
<source lang="mtmacro" line>
setAllStates(value, id, mapname)
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 {{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.}}
{{param|mapname|The name of the map to find the token.  Defaults to the current map.}}


|examples=
|examples=
Line 38: Line 34:
|changes=
|changes=
{{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.}}
}}
}}
{{change|1.5.4|Added {{code|mapname}} parameter option.}}
[[Category:State Function]]
[[Category:State Function]]

Revision as of 21:43, 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 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 to find the token. 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.