*createbuttongroup()

Adds a button group to the Utility menu.

Syntax

*createbuttongroup (page group name row column width color helpString macroName , arg1 …)

Type

HyperMesh Utility Menu

Inputs

page
The page number on which the button should appear.
group
The group ID for the button(s).
name
The text to be displayed on the button.
row
The row in which to place the button.
column
The column in which to place the button (1 – 10).
width
The width of the button (max. 10).
color
The button's color (see below).
helpstring
The help string to be displayed in the menu bar when the button is pressed.
macroname
The name of the macro to call when the button is selected.
arg1, …
Optional arguments to pass to the buttons macro.

Example

To create a button group on page 3 of the Utility menu that allows you to toggle a setting:

*createtext(3, "Display", 5, 0)
*createbuttongroup(3, 1, "yes", 5, 6, 2, GREEN, "Yes",
"ToggleDisplay", 1)
*createbuttongroup(3, 1, "no", 5, 8, 2, GREEN, "No", "ToggleDisplay", 0)

Rows in the Utility menu start with row one just above the menu bar, and progress upward.

Specifying page 0 indicates that you want the control to appear on all of the pages.

Button colors may be:

  • RED
  • BLUE
  • GREEN
  • CYAN
  • MAGENTA