selectTokens: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Fixed variable name)
m (Conversion script moved page selectTokens to SelectTokens without leaving a redirect: Converting page title to first-letter uppercase)
(No difference)

Revision as of 22:28, 9 February 2023

selectTokens() Function

Introduced in version 1.3b68
Selects one or more visible tokens on the map.

Usage

selectTokens()
selectTokens(id, add)
selectTokens(tokens, add, delim)

Parameter

  • id - the id string or token name of a specific token to select (the examples below use token names, but IDs are also permitted); if left blank all visible tokens are selected.
  • add - if the value of add is true(1), the selections will be added to the current set of selected tokens; if the value is false(0) currently selected tokens will be deselected before new tokens are selected. Defaults to false.
  • tokens - a String List of tokens to select.
  • delim - Specifies the delimiter used in the string list that is supplied. If the delimiter is "json", then the value for tokens may be a JSON Array instead. Note: if using a JSON Array or String List, both add and delim must be specified.

Example

To select a single token with the name "Adventurer":
[h:selectTokens("Adventurer")]

To select a list of Tokens using a String List, replacing the current selection

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

To select a list of Tokens using a JSON Array, adding the specified tokens to the current set of selected Tokens:

[h:selectTokens("['Adventurer', 'Orc 2', 'Goblin 1']", 1, "json")]

See Also

Version Changes

  • 1.3b68 - Function added.