Toolbar Button Control

1. Create a view.
2. Drag the control onto the canvas. You can find the control in the Action section of the Toolbox.
3. Configure the properties of the control (*optional).
4. Create a rule to action an event such as calling a SmartObject method and then show a message to the person using the view or form.
5. Run the view.

You can find the control in the Action section of the Toolbox.

Properties	Description	Can be set in runtime using rules?
Detail
Name	A unique identifier for the control. This property is required and defaults to the name of the control.	Yes, see SmartForm controls extensibility for more information.
Text	Specify text to use when displaying the control at runtime, for example Submit if the button is used to submit a view or form. Eliminate this value if you want to only show the icon.	Yes, see Configure the Set a Control's Properties Action for more information.
Tooltip	The value to display when the cursor hovers over the control.	Yes, see Configure the Set a Control's Properties Action for more information.
Settings
Icon	A drop-down list containing the icons that you can use with the control. You can use the advanced colors of a style profile to set the highlight, destructive, base, and base secondary color for the icon of this control. Click to enlarge	Yes, see Configure the Set a Control's Properties Action for more information.
General
Tab Index	Defines a sequence that users follow when they use the Tab key to navigate through a page at runtime.	Yes, see Configure the Set a Control's Properties Action for more information.
Visible	Shows or hides the control.	Yes, see Configure the Set a Control's Properties Action for more information.
Enabled	Enables or disables the control. If the control is disabled, you won't be able to use it.	Yes, see Configure the Set a Control's Properties Action for more information.
Format	Opens the Format page where you can configure formatting and style features such as format, font, borders, padding and margins. See the Format topic for more information.	No
Conditional Format	Opens the Conditional Formatting page. You can add conditional formatting to apply a specific format or style when a condition you set is True. Use conditional format on its own or with the Format feature. See Conditional Format for more information. Click the ellipsis to open the Conditional Formatting page.	No

The control interacts with other controls through rules. When you bind properties between different controls, you can use the data to populate properties or set values. Use the following examples for when to use the control with other controls through rules:

• Set a control’s properties: You can configure the settable properties of the control with this action
• Show/Hide: The Visible property allows you to show or hide the control through rules
• Enable/Disable: The Enabled property allows you to enable or disable the control through rules
• Data Transfer: You can transfer data from items listed in the context browser to the control
• Set Focus: You can use the Focus control method in the Rules Designer to set focus to the control in runtime

• You can place the control anywhere on the canvas. It does not have to be in the toolbar
• You can use the advanced colors of a style profile to set the highlight, destructive, base, and base secondary color for the icon of this control.
  
  Click to enlarge
• When using a style profile to customize the icon of the control, you cannot change the default icon color of the PDF Document (red) and Excel Document (green).