*createbutton()

Adds a button to the Utility menu.

Syntax

*createbutton (page name row column width color helpstring macroname arg1 …)

Type

HyperMesh Utility Menu

Inputs

page
The page number on which the button should appear.
name
The text to be displayed on the button.
row
The row in which to place the button. There is no limit to this value, but if the value is too high the button may not be visible because its location exceeds the available area.
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,…
The name of the macro to call when the button is selected.

Example

To create a button on page 5 of the Utility menu:

*createbutton(5, "input", 5, 0, 10, GREEN, "Create an element",  "ReadBumper")

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
  • YELLOW
  • GREY
  • BUTTON (background)