setMacroCommand: Difference between revisions
Jump to navigation
Jump to search
Bubblobill (talk | contribs) m (From v1.15, accepts "campaign" and "gm" as ids for the relevant panels.) |
Bubblobill (talk | contribs) mNo edit summary |
||
| (One intermediate revision by the same user not shown) | |||
| Line 10: | Line 10: | ||
setMacroCommand(index, command) | setMacroCommand(index, command) | ||
setMacroCommand(index, command, id) | setMacroCommand(index, command, id) | ||
setMacroCommand(index, command, id, | setMacroCommand(index, command, id, mapRef) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''Parameters''' | '''Parameters''' | ||
| Line 16: | Line 16: | ||
{{param|command|A string containing the command to set on the macro button.}} | {{param|command|A string containing the command to set on the macro button.}} | ||
{{param|id|The token {{code|id}} of the token that the command is set on. From v1.15, accepts "campaign" and "gm" as ids for the relevant panels.}} | {{param|id|The token {{code|id}} of the token that the command is set on. From v1.15, accepts "campaign" and "gm" as ids for the relevant panels.}} | ||
{{param| | {{param|mapRef|The Name or ID of the map to find the token. Defaults to the current map.}} | ||
|examples= | |examples= | ||
| Line 27: | Line 27: | ||
{{change|1.3b51|Added {{code|id}} parameter option.}} | {{change|1.3b51|Added {{code|id}} parameter option.}} | ||
{{change|1.5.11|Added {{code|mapname}} parameter option.}} | {{change|1.5.11|Added {{code|mapname}} parameter option.}} | ||
{{change|1.15|Addition of "gm" and "campaign" options for id}} | |||
}} | }} | ||
[[Category:Metamacro Function]] | [[Category:Metamacro Function]] | ||
Latest revision as of 23:59, 17 March 2024
setMacroCommand() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.3b48
Sets the command that will be run when the Macro Button is pressed. Note because of the way the parser interprets values within [] you may have to use the encode() and decode() functions with the string.
Usage
setMacroCommand(index, command)
setMacroCommand(index, command, id)
setMacroCommand(index, command, id, mapRef)Parameters
index- The index of the macro button.command- A string containing the command to set on the macro button.id- The tokenidof the token that the command is set on. From v1.15, accepts "campaign" and "gm" as ids for the relevant panels.mapRef- The Name or ID of the map to find the token. Defaults to the current map.
Examples
[h: setMacroCommand(1, "[macro('Test@Lib:Test'): '']")]Version Changes
- 1.3b49 - Changed to a trusted function.
- 1.3b51 - Added
idparameter option. - 1.5.11 - Added
mapnameparameter option. - 1.15 - Addition of "gm" and "campaign" options for id