Add a Button Widget to a Dashboard
Use the Dashboard Editor to add a button widget to a dashboard.
A button widget is capable of executing a single Action when selected.
This topic describes defining a background color on a form with a universal theme. If you are editing a form with a classic theme, use this link to open the previous version of Add a Button Widget to a Dashboard.
Good to know:
- A button widget is highly configurable. Add one or many to a dashboard, then define the Action to execute when the button is selected, and how the button looks and behaves on the dashboard (example: text, size, color, background style and gloss, border style, image, alignment, anchoring, layering, and visibility). See Define How a Widget Looks and Behaves on a Dashboard.
- Text, image, and colors can be conditional (expression-driven).
- See Dashboard Editor Behaviors for tips on working with widgets on dashboards.
To Add a Button Widget to a Dashboard
- Open a dashboard in the Dashboard Editor.
- Drag the Button Widget from the Shapes, etc tree onto the dashboard.
- Define the Action to execute when the button is selected:
- Right-click the Button Widget, and then select Widget Properties > Widget Properties.
- Select the ellipsis to open the Action Manager, and then select the Action to execute.
- If you selected a One-Step Action™, you can either select or clear the Show Progress check box to control whether the progress dialog for the One-Step Action appears while it runs.
- Define the text to display on the button:
- In the Label text box on the Dashboard Editor toolbar, provide the text to display on the button.
- (Optional) Change the font, font size, font style, font alignment, and text wrap, if needed.
- Define the background color for the button widget:
- Right-click the Button Widget, and then select Widget Properties.
- Select Button color to launch the Color Selector. You can select a theme color, or define a custom color for the button background.
Color gradients are not available for dashboards using universal themes.
- Define how the button widget looks and behaves (example: Size, alignment, etc.).
Continue making changes, or select OK to save and close the editor.