12.1.2.1.1.22. Radio-Button List

Unlike checkbox controls, which allow users to select multiple options at once, radio button controls allow users to choose only one option from a set of mutually exclusive options.

*Radio buttons are particularly effective in implementing business rules, where specific actions can be triggered based on the user’s selection. For example, if the user select Option A, then the XYZ fields will be displayed, whereas selecting Option B will result in a different set of fields being shown. For more information on business logic and rules, click here.

When a radio 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 link a control to its corresponding attribute and define its binding properties.
   • For more information on the fields in this category, click here.

*When creating attributes for radio button controls, there are various data types to choose from, including string data types (such as Char, NChar, NText, NVarChar, or Text), numeric data types (such as Decimal, Float, Int, Numeric, or Real) , and the Bit (Boolean) data type. Please note, however, that if you choose the Bit (Boolean) data type, you can only have two options available. If you require more than two options, then using a different data type is necessary to ensure proper functionality of the workflow.

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.
3. Control Behavior: In this category, users can configure the behavior of the control and define how it interacts with the form or application.

   • Radio Button Initial Value

     Both the Initial Value field and the Selected checkbox (described below) are used to pre-select radio button options.

     !!The Initial Value field defines the pre-selected value per form behavior, while the Selected checkbox defines the pre-selected value for the entire workflow.

     • If both properties are set, the Initial Value overrides the Selected checkbox.
       
     • If the Initial Value matches a radio button option, that option will be pre-selected.
       
     • If the Initial Value doesn’t match any option, nothing will be pre-selected.
       
     • If the Initial Value is not set, the option with the Selected checkbox checked will be pre-selected.
       

   • For more information on these properties and how to configure them, click here.

     !!Please note that when it comes to control governance properties, users are limited to configuring only the required field validation properties for radio button controls. It is not possible to set up required range validations.

4. Appearance: In this category, users can customize the visual appearance of the control.
   • Tooltip: This field allows users to input a tooltip for the control.
     • In the web application, the tooltip is represented by the tooltip icon ( ) next to the control.

     • Radio Button Tooltip Preview: Web View

       **A tooltip is a brief message or description that appears when the user hovers their cursor over the tooltip icon next to the control. This feature can help to provide additional context and guidance to the user as they interact with the form or application.

5. Caption Appearance: In this category, users can customize the visual appearance of the control’s caption.
   • For more information on the fields in this category, click here.
6. Misc: In this category, users can define additional properties for the control.
   • Items: This field allows users to create and customize items or options for the radio button.
     • To access the List Items Editor, click on the ellipses () inside Items field.
       
       • Add: This button allows users to add a new item.
         • Once added, the new item will be displayed in the Items box and its properties will be shown in the Item section.
           • Value: This is a text field that allows users to input the data value for the item.
             • This value corresponds to a specific item in the radio button. When users select the item, the corresponding value is sent to the server, allowing it to be processed in the backend.
               

               **It’s important to make sure that the value entered matches the item selected and is in the correct format for the data type you are working with (e.g., “true” or “false” for boolean values, or “0” or “1” for integer values). It is recommended to keep the value simple, as it will be used to write business logic if necessary.

           • Caption: This is a text field that allows users to input the displayed name or caption of the item.
             • As English is set as the default language in the system, any caption inputted in the English caption field will be used as the display caption for the item, regardless of other language options that may be available.
               

               **Users can determine which languages are available for use in the Settings of the Designer. Currently, however, only five languages are supported on the web server: English, French, German, Arabic, and Hebrew.

               !!Please note that for the translation to be effective on the radio button control, the form must be saved and closed beforehand.

           • Selected: This checkbox determines whether the radio button option is pre-selected or not.
             • To pre-select an option, users must check the Selected checkbox for that option.
               

               **When a user accesses a radio button control, the option that is pre-selected will be chosen by default. Only one option can be pre-selected at a time.

           • Enabled: This checkbox determines whether the radio button option is available for selection or not.
             • To disable an option, users must uncheck the Enabled checkbox for that option.
               

               !!If an option is not enabled, it cannot be selected by the user in the web application.

       • Remove: This button allows users to remove a selected item.
       • Up / Down: These buttons allow users to reorder the items in the list.
         • To move an item up or down, select it from the list and click on the Up or Down button. This will move the selected item one position up or down in the list, respectively.
       • OK: This button allows users to save their changes and exit the List Items Editor window.
   • Repeat Columns: This field allows users to specify the number of columns in which the radio button options will be arranged.
     • By default, the number of columns is set to 1. To adjust this value, users can enter numbers into the field either manually or by clicking the increment/decrement arrows.
   • Repeat Directions: This field allows users to specify the direction in which the radio button options will be arranged.
     • Directions: Vertical or Horizontal.
       • Horizontal: This option arranges the radio button options in rows from left to right.
       • Vertical: This option arranges the radio button options in columns from top to bottom.

Radio Button Control Preview: Web View

Customizing Radio Button Control: Web View

Design A – Pre-Selected Option (Active); Design B – Direction: Vertical; Design C – Direction: Horizontal; Design D – Columns: 3, Direction: Vertical

Quick Forms Application

To apply the Quick Forms feature to radio button controls, take the following steps:

• Drag a radio button control from the toolbox and drop it onto the design environment.
• Provide a caption for the control.
• Save the form and select Yes in response to the following prompt:
  
  
  

*For more information on the Quick Forms feature, click here.