ProApp Designer - Release 14 (Package 22)

ButtonGroup Control

ButtonGroup control is used to display a group of buttons or a single button. Using button control you can implement custom action. Each button can be configured to show a dialog or a shortcut to the existing Innovator page. Button can also be configured to call a custom script.

  • Name: It is used to uniquely identify control inside the template.
  • Label: It is used to show title on the button group. It can be localized by defined Languages and Locales inside innovator.
  • Buttons: It allows you to define single or multiple buttons in the group. You can configure each button with a name and on-click handler. Each button can also be assigned with an icon, fore color, and background color.

    When you click on tick icon under OnClick column the following dialog will be shown. In the dialog, you can select one of the dialogs defined in the template that will be shown when user clicks on the button. You can also configure existing Innovator actions like Structure Browser, Where Used, Workflow Signoffs to be shown in Innovator tab for the context item. By selecting Script option in the dialog, you can associate custom script that contains code to interact with other controls in the Wizard. Script can also have code to interact with server by sending a request. For each button, you can configure icon, text and background colors. For each button, you can also define “Can Show” script that should return Boolean value. If returned value is false, button hidden. If it is null, button will be shown as disabled.

  • Orientation: It allows you to show buttons either horizontally or vertically stacked within its parent group control.

  • Alignment: It allows you to show buttons aligned to left, center, or right in the available width of the parent group control.

  • Access: It allows you to define roles which can access control. You can configure Roles (in the form group identities) to whom this control should be shown.
  • Display Condition: Based on the option selected for Display Condition, the control will be shown or hidden in the wizard at runtime. You can select one of the options like ‘Always Show’, ‘Always Hide’, ‘Expression’, or ‘Script’. Expression allows you to define a Boolean expression using properties from the current and previous pages (in case of multi-page application) to conditionally display the control if expression is evaluated to true. Expression will be evaluated based on the cached property values on the client. Script allows you to write custom JavaScript code that should return Boolean value. If returned value is false, the control will be hidden.
  • Border: It allows you to show or hide the border and legend of the button group.
  • Font: It allows you to set the required font and size for the button names.
  • Margin: It allows you to set the required top, right, bottom, left margins with respect to adjacent controls.