setAllStates: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Typo)
 
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{stub|Examples using new functionality.}}
{{MacroFunction
{{MacroFunction
|name=setAllSates
|name=setAllStates
|version=1.3b40
|description=
|description=
Sets all of the [[Token:state|Token States]] of the [[Token:Current Token|Current Token]] to on (non zero) or off (0).
Sets all of the [[State|States]] of a [[Token]] to on ({{true}}) or off ({{false}}).


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro">
[h: setAllStates(val)]
setAllStates(value)
</source>
setAllStates(value, id)
setAllStates(value, id, mapname)
</syntaxhighlight>
'''Parameter'''
{{param|value|If all states should be set on or off, {{true}} or {{false}}.}}
{{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 to find the token.  Defaults to the current map.}}


|examples=
|examples=
Set all [[Token:state|Token States]] on
Set all [[Token:state|Token States]] on
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
    [h: setAllStates(1)]
[h: setAllStates(1)]
</source>
</syntaxhighlight>
Set all [[Token:state|Token States]] off
Set all [[Token:state|Token States]] off
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
    [h: setAllStates(0)]
[h: setAllStates(0)]
</source>
</syntaxhighlight>
 
|also=
[[State]], [[getState|getState()]], [[setState|setState()]]
 
|changes=
{{change|1.3b51|Added {{code|id}} parameter option.}}
{{change|1.5.4|Added {{code|mapname}} parameter option.}}
}}
}}
[[Category:State Function]]
[[Category:State Function]]

Latest revision as of 01:19, 10 February 2024

 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.

setAllStates() 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.