RPTools

Personal tools
From MapToolDoc

deselectTokens

Contents

deselectTokens() Function

Introduced in version 1.3b68

Deselects one or more visible tokens on the map.

Usage

  1. deselectTokens()
  1. deselectTokens(id)
  1. 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 for list 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":

  1. [h:deselectTokens("Adventurer")]

To deselect a list of Tokens using a String List:

  1. [h:deselectTokens("Adventurer, Orc 2, Goblin 1", 0, ",")]

See Also

selectTokens(), getSelected(), getSelectedNames()

Version Changes

  • 1.3b68 - Function added.