deselectTokens: Difference between revisions
Jump to navigation
Jump to search
(New page: {{MacroFunction |name=deselectTokens |version=1.3b68 |description= Deselects one or more visible tokens on the map. |usage= <source lang="mtmacro"> deselectTokens() </source> <source lan...) |
No edit summary |
||
(2 intermediate revisions by the same user not shown) | |||
Line 6: | Line 6: | ||
|usage= | |usage= | ||
<source lang="mtmacro"> | <source lang="mtmacro" line> | ||
deselectTokens() | deselectTokens() | ||
</source> | </source> | ||
<source lang="mtmacro"> | <source lang="mtmacro" line> | ||
deselectTokens(id) | deselectTokens(id) | ||
</source> | </source> | ||
<source lang="mtmacro"> | <source lang="mtmacro" line> | ||
deselectTokens(tokens, delim) | deselectTokens(tokens, delim) | ||
</source> | </source> | ||
'''Parameter''' | '''Parameter''' | ||
* {{code|id}} - the id string of a specific token to deselect; if left blank all currently selected tokens are deselected. | * {{code|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. | ||
* {{code|tokens}} - a [[String List]] of tokens to deselect. | * {{code|tokens}} - a [[String List]] of tokens to deselect. | ||
* {{code|delim}} - Specifies the delimiter used in the string list that is supplied. If the delimiter is "json", then the value for {{code|list}} may be a [[JSON Array]] instead. '''Note: if using a JSON Array or String List, {{code|delim}} must be specified.''' | * {{code|delim}} - Specifies the delimiter used in the string list that is supplied. If the delimiter is "json", then the value for {{code|list}} may be a [[JSON Array]] instead. '''Note: if using a JSON Array or String List, {{code|delim}} must be specified.''' | ||
Line 32: | Line 32: | ||
</source> | </source> | ||
|also= | |||
[[selectTokens|selectTokens()]], | |||
[[getSelected|getSelected()]], | |||
[[getSelectedNames|getSelectedNames()]] | |||
|changes= | |changes= |
Revision as of 16:31, 26 October 2010
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 forlist
may be a JSON Array instead. Note: if using a JSON Array or String List,delim
must 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.