Radio Button controls

The Radio Button and Radio Button Group controls are used instead of the Radio Button List control when a layout is required where the buttons are not visually grouped together.

1. Create a View.
2. Drag one or more Radio Button controls onto the design canvas.
3. Configure the rest of the properties of the Radio Button control.
Optional
1. If two or more Radio Buttons are used and grouping is required, drag the Radio Button Group control onto the design canvas.
2. Group the two Radio Buttons together by selecting the Radio Button Group in the Group field of the Radio Button control’s Properties.
3. Configure the rest of the Properties of the controls as required. Configure unique values in the Value properties of the Radio Button controls when using these controls in advanced conditions or data transfer rules. These values are used to determine the specific value of the Radio Button control within the Radio Button Group control.
4. Configure rules if required.
5. Run the View.

1. When used with the Radio Button Group control, Radio Button controls need to be grouped together by selecting the Radio Button Group control in the Group property of each Radio Button control. The Radio Button Group control is not visible at runtime. It is only used for grouping purposes.
2. When using the Radio Button control with the Radio Button Group control in advanced conditions or data transfer for example, the Value property of the grouped Radio Buttons need to be set and unique so that the Radio Button Group control can determine its specific value within the Group control.
3. Tab Index behavior - If the Tab Index property of any control on a View or Form is set, using the tab key at runtime will navigate to the first Radio Button in the Group. Focus to the rest of the Radio Buttons within the Group can be set by using the up and down or left and right arrow keys. If the Tab Index property has not been set for any of the controls on the View, or any View on the Form, and none of the Radio Buttons in the Group is selected, the user will be able to tab to all the Radio Buttons depending on the type of browser used. If a Radio Button is then selected, focus can be set to the rest of the Radio Buttons by use of the arrow keys.

The Radio Button and Radio Button Group controls are used instead of the Radio Button List control when a layout is required where the buttons are not visually grouped together.

1. Create a View.
2. Drag two or more Radio Button controls onto the design canvas.
3. Drag the Radio Button Group control onto the design canvas.
4. Group the two Radio Buttons together by selecting the Radio Button Group in the Group field of the Radio Button control’s Properties.
5. Configure the rest of the Properties of the controls as required. Configure unique values in the Value properties of the Radio Button controls when using these controls in advanced conditions or data transfer rules. These values are used to determine the specific value of the Radio Button control within the Radio Button Group control.
6. Configure rules if required.
7. Run the View.

1. The Radio Button Group control cannot function on its own. Radio Button controls need to be grouped together by selecting the Radio Button Group control in the Group property of each Radio Button control.
2. The Radio Button Group control is not visible at runtime. It is only used for grouping purposes.
3. When using the control in advanced conditions or data transfer for example, the Value property of the grouped Radio Buttons need to be set and unique so the Radio Button Group control can determine its specific value within the Group control.

The Radio Button List control is used when a layout is required where the buttons are visually grouped together.

1. Create a View.
2. Drag the control onto the design canvas.
3. Configure the Properties of the control.
4. Make sure to configure the data source so the list can be populated at runtime.
5. Run the View.

1. Values can be transferred to the Radio Button List by using the Transfer Data action mappings screen.
2. The value should correspond to the list item value.
3. A Radio Button List can be associated to a SmartObject or have static list values.
4. Focus can be set to this control at runtime by using the Focus control method in the Rule Designer.
5. The Horizontal property has been replaced by the Stacked by and No. of items properties. See the Radio Button List items per row or column section.

When clicking on the ellipsis next to Data Source Type, the Configure Data Source screen opens. Configure the data source to be used.

A Boolean (Yes/No) property can be configured that will be used as the Default value in the Data Source Configuration popup. The value(s) set to true for the Boolean property will be returned to the control at runtime and be displayed according to the control used.

How to use the default value

• Create a SmartObject with a property of type Yes/No to be used to capture the default value.
• Generate an Item View and create some data for the SmartObject. We've used the Marital status SmartObject with the following data:
  • Single
  • Married
  • Divorced
  • Widowed
  Below is a List View displaying the values captured. Note the Single value has been configured as the default.
  
• Create another View that will be using the SmartObject containing the default value, for example an Employees Item View.
• Edit the View and drag a Radio Button List control onto the canvas.
• Select the Marital status SmartObject as the data source of the control and the property used to identify the default in the Default Value field .
  
• Save the configuration.
• Run the View and note the default of the control.
  

• When using a change event on the control, for example "When a control [Radio Button List] on the View/Form raises an event [Changed]", and a non-empty value is specified, the change event of the control will be executed when the View/Form initializes.

When selecting to Use a static list of values in the control and clicking on the ellipsis, the Fixed List Configuration screen opens. The ability is provided to configure a Value-Display pair where the value of the Value field is stored in the SmartObject, while the value of the Display field is displayed to the user. The Value is then used to reference a Display value that will be displayed to the user during runtime.

Design time configuration

Runtime

Considerations

• Blank values are permitted.
• Values do not need to be unique which might cause some logical errors.
• The Radio Button List control can only contain one default.
• When the View's Clear method is executed, the Radio Button List control will revert to the default value, not a blank value.
• When upgrading from an older version of SmartForms to version 4.6.9 or later, both the Value and Display fields are set to the previous version's Display value of existing applications to ensure backwards compatibility.

The ability to define the amount of rows/columns to be used as a display is provided. The Stacked by and No. of items properties of the control can be configured to achieve this. When stacking by Rows, the layout will be from left to right until the number of items per row has been reached, then a new row will be created. When stacking by Columns, the layout will be from top to bottom until the number of items per column has been reached, then a new column will be created. The properties are located in the Settings section as shown below:

See the following examples:

Stacked by Rows
Number of items = 4

Stacked by Columns
Number of items = 4

Considerations

• The Stacked by and No. of items properties of existing controls will default to Rows and 1 when upgraded to K2 smartforms 4.6.9.

For-Each looping rule conditions are available for use on List Views and list controls. For more information see the Rule Conditions topic.