Macro Button
The Macro Button displays a button on the user form that when clicked will run a macro.
The name of the macro to launch is set in the Macro Name property.
This must result the name given to a macro that exists in the project; for example:
"MyMacro"
When the form control is applied the name entered will display as the caption for the form control. This can
be changed by selecting the Text property.
Properties
Appearance
Appearance - Border
Appearance - Picture
Appearance - Text
- Font
Specifies the font of the text shown in the control.
- Text Color
Specifies the color of the control's text.
- Text Color (Disabled)
Specifies the color of the control's text when the control is disabled.
- Text Color (Hover)
Specifies the color of the control's text when the control is in a hovered state.
- Text Color (Pressed)
Specifies the color of the control's text when the control is in a pressed state.
- Text Horizontal Alignment
Controls whether the text is horizontally aligned to the left, right or center
Behavior
- Enabled
Controls whether the control is enabled (if the result is TRUE) or disabled (if the result is
anything other than TRUE, e.g. FALSE).
- Error Result
Determines whether the value of the control is in error. The result of this rule is a string
containing the error message if the value is in error, otherwise a blank string or the
number zero.
- Macro Argument
Provides an optional argument to the macro
- Macro Name
Determines the name of the macro to fire when the macro button is clicked.
- Tab Index
Configures the position of the control in the form tab order.
- Text
Specifies the text shown in the control.
The text displayed in this property can have formatting tags applied to decorate parts of the text string, see Formatting the Displayed Text below for more information.
- Visible
Determines whether the control is visible (TRUE) or hidden (FALSE).
General
- (Metadata)
Optional text which can be used to provide information belonging to or about a control. For
example, a list of CSS classes which can be parsed and applied to the control using the
Integration Theme in DriveWorks Live. This doesn't affect the control's behavior.
- (Name)
The name of the control
- (Tag)
Optional text which can be used to describe the control, but which doesn't affect the
control's behavior.
- Tooltip Duration
Controls the duration, in seconds, for which the tooltip will remain visible. Values of 0 and
below indicate an infinite duration.
- Tooltip Text
Specifies the text to display in a tooltip when hovering over the control.
The text displayed in this property can have formatting tags applied to decorate parts of the text string, see Formatting the Displayed Text below for more information.
Layout
- Height
Controls the height of the control.
- Left
Controls the left position of the control.
- Top
Controls the top position of the control.
- Width
Controls the width of the control.
Formatting the Displayed Text
Formatting Text
The text displayed in the Text and Tooltip Text property support the use of formatting tags to format parts of the text string.
The supported tags are:
Please note
Text displayed on the Macro Button cannot be formatted to link to another page.
However the Macro Button can run a macro that uses the Navigate to URL task.
See How To: Format Text for more information.

A user form control that, when selected, will run a VBA
macro.