Show TOC

Background documentationConfigure Button Task Panel Locate this document in the navigation structure

 

The Configure Button task panel enables you to define attributes for a button control. A button control is used to trigger actions when it is clicked with the mouse or activated using the keyboard.

The following table describes the properties and attributes of this model element:

Group

Property

Description

General

Label

The label text to be displayed to the left of the control. You can either enter the text directly in the Label field, or click the fx button to define the label text using the Dynamic Expression Editor dialog box.

Text

The text to be displayed on the control. The width of the control automatically resizes to match the length of the text defined.

You can either enter the text directly in the Text field, choose a field from the dropdown list, or choose Define expression from the dropdown list to specify the text using the Dynamic Expression Editor dialog box.

Enabled

Indicates whether the control is enabled or disabled at runtime. A disabled control is displayed, but is grayed out, and cannot be activated by the runtime user.

You can select or deselect the checkbox to specify whether the control is enabled or disabled, or click the fx button to define the expression that specifies under which condition the control is enabled or disabled at runtime.

Visible

Indicates whether the control is hidden or displayed at runtime.

You can select or deselect the checkbox to specify whether the control is hidden or visible, or click the fx button to define the expression that specifies under which condition the control is displayed or hidden at runtime.

Indent

Defines the alignment of the control within the layout column.

You can select or deselect the checkbox to specify whether the control is indented or left-aligned, or click the fx button to define the expression that specifies under which condition the control is indented at runtime.

For some control types, left-aligning the control hides the label and stretches the control to fill the entire column width; for other control types, it hides the label and left-aligns the control (without changing the control width).

Tooltip

Text to be displayed in a tooltip over the element at runtime.

You can either enter the tooltip text directly in the Tooltip field, or click the fx button to define the tooltip using the Dynamic Expression Editor dialog box.

Action

The event to be triggered or action to be executed when the control is clicked at runtime.

You can either enter the name of a custom action directly in the Action field, or you can click the browse button to open the Define Action dialog box and define an action. Use an asterisk (*) before an event name to indicate that if any event of the same name (without the asterisk) is raised, all events of the name with the asterisk will respond.

More information: Define Action Dialog Box.

Button style

Type of button:

  • Default button: The button that is triggered automatically when the runtime user presses the ENTER key after the application window opens, without navigating to a different control in the view. You should define only one default button for each runtime window.

  • Normal button: A standard button (not a default button).