deselectTokens: Difference between revisions
Jump to navigation
Jump to search
m (Text replacement - "source>" to "syntaxhighlight>") |
m (Text replacement - "<source" to "<syntaxhighlight") |
||
| Line 6: | Line 6: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
deselectTokens() | deselectTokens() | ||
</syntaxhighlight> | </syntaxhighlight> | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
deselectTokens(id) | deselectTokens(id) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
deselectTokens(tokens, delim) | deselectTokens(tokens, delim) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 23: | Line 23: | ||
|example= | |example= | ||
To deselect a single token with the name "Adventurer": | To deselect a single token with the name "Adventurer": | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h:deselectTokens("Adventurer")] | [h:deselectTokens("Adventurer")] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
To deselect a list of [[Token]]s using a [[String List]]: | To deselect a list of [[Token]]s using a [[String List]]: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h:deselectTokens("Adventurer, Orc 2, Goblin 1", 0, ",")] | [h:deselectTokens("Adventurer, Orc 2, Goblin 1", 0, ",")] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Revision as of 18:53, 14 March 2023
deselectTokens() Function
• Introduced in version 1.3b68
Deselects one or more visible tokens on the map.
Usage
deselectTokens()deselectTokens(id)deselectTokens(tokens, delim)Parameter
id- the id string or name of a specific token to deselect (the examples below use the token name, but token IDs are also valid); if left blank all currently selected tokens are deselected.tokens- a String List of tokens to deselect.delim- Specifies the delimiter used in the string list that is supplied. If the delimiter is "json", then the value forlistmay be a JSON Array instead. Note: if using a JSON Array or String List,delimmust be specified.
Example
To deselect a single token with the name "Adventurer":
[h:deselectTokens("Adventurer")]To deselect a list of Tokens using a String List:
[h:deselectTokens("Adventurer, Orc 2, Goblin 1", 0, ",")]See Also
Version Changes
- 1.3b68 - Function added.