getMacroProps: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(New page: ==Function getMacroProps== {{ProposedChange}} Returns a Macros:string property list of the properties for a macro button for the current Token:token. You can retrieve the ind...)
 
No edit summary
Line 6: Line 6:
===Usage===
===Usage===
<source lang="mtmacro" line>
<source lang="mtmacro" line>
[h: setMacroProps(label, props, delim)]
[h: getMacroProps(label, props, delim)]
[h: setMacroProps(index, props, delim)]
[h: getMacroProps(index, props, delim)]
</source>
</source>
Where  
Where  

Revision as of 22:41, 1 December 2008

Function getMacroProps

 Note: This refers to a proposed change that has not been implemented in the main code base yet.

Returns a Macros:string property list of the properties for a macro button for the current token. You can retrieve the index of a macro button with the getMacroIndexes() function.

Usage

[h: getMacroProps(label, props, delim)]
[h: getMacroProps(index, props, delim)]

Where

  • label is the label for the macro button. If you specify a label then all macro buttons on the token that have that label will be updated.
  • index is the index of the macro button.
  • props is a string property list containing the properties for the button.
  • delim is the delimiter used to separate the values in the string property list which defaults to ';' if not specified.

Valid Properties for Macro Buttons

  • autoExec - true/false - Will the macro be automatically executed when the button is clicked on.
  • color - The name of the color for the button.
  • fontColor - The name of the font color for the button.
  • includeLabel - true/false - Will the label be output when the button is clicked.
  • group - The name of the group that the button is in.
  • sortBy - The sort by value of the macro button.
  • index - The index of the button.
  • label - the lavle of the button.
  • fontSize - The size of the font for the button.
  • minWidth - the minimum width of the button.