getAlwaysVisible: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Conversion script moved page GetAlwaysVisible to getAlwaysVisible: Converting page titles to lowercase)
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 6: Line 6:


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
getAlwaysVisible([id])
getAlwaysVisible([tokenRef])
</source>
</syntaxhighlight>


'''Parameters'''
'''Parameters'''
{{param|value|The value of the setting to set, {{code|true}}({{code|1}}) or {{code|false}}({{code|0}}).}}
{{param|value|The value of the setting to set, {{code|true}}({{code|1}}) or {{code|false}}({{code|0}}).}}
{{param|id|OPTIONAL: The token {{code|id}} of the token for which you want to set this setting, defaults to the [[Current Token]]. {{TrustedParameter}} }}
{{param|tokenRef|OPTIONAL:Either the token [[getSelected|{{code|id}}]] or [[getTokenName|Token Name]] of the token for which you want to set this setting, defaults to the [[Current Token]]. {{TrustedParameter}} }}
{{Note|Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.}}


|example=
|example=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
The Always Visible setting for Dragon is currently set to: [r: getAlwaysVisible("Dragon")]
The Always Visible setting for Dragon is currently set to: [r: getAlwaysVisible("Dragon")]
[h, token("Dragon"): isVisible = getAlwaysVisible()]
[h, token("Dragon"): isVisible = getAlwaysVisible()]
</source>
</syntaxhighlight>
}}
}}
[[Category:VBL Function]]
[[Category:VBL Function]]

Latest revision as of 02:44, 13 May 2024

getAlwaysVisible() Function

Introduced in version 1.4.2.0
Returns the value of the corresponding setting for the token. Always Visible is a VBL setting which can be found in the Edit... menu of the token under the VBL tab.

Usage

getAlwaysVisible([tokenRef])

Parameters

  • value - The value of the setting to set, true(1) or false(0).
  • tokenRef - OPTIONAL:Either the token id or Token Name of the token for which you want to set this setting, defaults to the Current Token.

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

Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.

Example

The Always Visible setting for Dragon is currently set to: [r: getAlwaysVisible("Dragon")]
[h, token("Dragon"): isVisible = getAlwaysVisible()]