getMacros
getMacros() Function
• Introduced in version 1.3b48
Returns a list of the labels of all of the macro buttons on the Current Token. The type of the value returned depends on the delimiter parameter.
Usage
<syntaxhighlight lang="mtmacro" line> getMacros() getMacros(delim) getMacros(delim, id) getMacros(delim, id, mapname) </source> Parameters
delim
- The delimiter used to separate the values in the String List, a JSON array is returned if"json"
is specified as the delimiter. Defaults to","
id
- The tokenid
of the token that the function is executed on.Note: This parameter can only be used in a Trusted Macro.
mapname
- The name of the map to find the token. Defaults to the current map.
Examples
To display all of the macro button labels on the current token use.
<syntaxhighlight lang="mtmacro" line>
[h: macroLabels = getMacros()]
[foreach(macro, macroLabels, "
"): macro]
Version Changes
- 1.3b49 - Added
json
delimiter option. - 1.3b51 - Added optional token
id
parameter. - 1.5.11 - Added
mapname
parameter option.