12.1.2.1.1.3. Button

Buttons are an essential element in form development, allowing users to interact with forms in a variety of ways. With buttons, users can store and send form information, trigger actions and events, and execute custom code to perform specific tasks.

When a button control is selected in the design environment, its associated properties are displayed in the Control Properties panel.

*To access the Control Behavior category, users must first create the form behavior.

1. Binding: In this category, users can define the binding properties of the control.
   • Control Properties: This field allows users to configure the control properties.
     • For more information on these properties and how to configure them, click here.

!Users do not need to create or link an attribute for button controls.

2. Name: In this category, users can access basic properties required for the control’s identification and proper referencing in the code.
   • For more information on these properties and how to configure them, click here.

!When inputting a name for a button control, users can only use the Caption field. They cannot set a name by double-clicking on the control.

3. Control Behavior: In this category, users can configure the behavior of the control and define how it interacts with the form or application.
   • For more information on these properties and how to configure them, click here.

!For button controls, users can select the form behavior, view the current control state, and modify the control state using the State Matrix field. Please note that the linked section contains information on other fields that do not apply to button controls and can be disregarded.

4. Appearance: In this category, users can customize the visual appearance of the control.
   • Button Color: This is a single-select dropdown field that allows users to choose the color of the button.
     • Button Colors: Default, Primary, Success, Info, Warning, Danger, or Link.

       • Button Color Preview: Design View vs. Web View

   • Is Block: This is a checkbox which, if selected, allows the button to expand to fill the available space within the layout box.
     • If this checkbox is left unselected, the button will be sized according to its content, and may not take up the full width of the box.

       • Button Width Preview: Is Block Checkbox (Unselected/Selected)

   • Size: This is a single-select dropdown field that allows users to choose the size of the button.
     • Button Sizes: Large, Medium, Small, or Tiny.

       • Button Size Preview: Web View

5. Misc: In this category, users can define additional properties for the control.
   • Default Action: This is a single-select dropdown field that allows users to choose the default action of the button.
     • Button Actions: Default, Submit, or Save.
       • Default: This action allows the button to perform a specific action that can be configured by code.
         • Users, for example, can configure the button to perform tasks such as selecting all items in a given grid, importing items from one grid to another, or copying a previous form’s content.
       • Submit: This action allows the button to submit the form.
       • Save: This action allows the button to save the form.

*A default action defines the default behavior of the button when it is clicked in the form.