getMacroButtonIndex: Difference between revisions
Jump to navigation
Jump to search
Verisimilar (talk | contribs) m (This function doesn't seem to work, and I can't find any documentation that says it ever actually made it into a build. Take off the proposed if I'm wrong about this.) |
No edit summary |
||
(4 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
{{stub}} | {{stub|Expanded examples of usage.}} | ||
{{MacroFunction | {{MacroFunction | ||
|name=getMacroButtonIndex | |name=getMacroButtonIndex | ||
|version=1.3b50 | |version=1.3b50 | ||
|description=Returns the index of the macro button that was clicked on | |description= | ||
Returns the index of the [[Token]] macro button that was clicked on. The macro button must have the auto-execute check box selected. If the macro is not running from a [[Token]] macro button then {{code|-1}} is returned. | |||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
getMacroButtonIndex() | |||
</ | </syntaxhighlight> | ||
|example= | |example= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: ind = getMacroButtonIndex()] | [h: ind = getMacroButtonIndex()] | ||
</ | </syntaxhighlight> | ||
If the macro is not run from an auto-execute macro button on a [[Token]], {{code|ind}} is set to {{code|-1}}. Otherwise {{code|ind}} is set to a non-negative number which is the index of the button. | |||
|also= | |||
{{func|getMacroIndexes}} | |||
}} | }} | ||
[[Category:Metamacro Function]] | [[Category:Metamacro Function]] |
Latest revision as of 23:59, 14 March 2023
This article is a stub, you can help the RPTools Wiki project by contributing content to expand this article.
This article needs: Expanded examples of usage.
getMacroButtonIndex() Function
• Introduced in version 1.3b50
Returns the index of the Token macro button that was clicked on. The macro button must have the auto-execute check box selected. If the macro is not running from a Token macro button then
-1
is returned.Usage
getMacroButtonIndex()
Example
[h: ind = getMacroButtonIndex()]
ind
is set to -1
. Otherwise ind
is set to a non-negative number which is the index of the button.