Defining a Radio Button Group Control 

Use

You use this procedure to define the properties and event handlers for a radio button group control. The radio button group control groups radio button controls to create a set of exclusive options. At runtime, the user can select only one radio button in a radio button group.

A radio button group control:

·        Cannot be included in a grid of a list tile

·        Can be bound (associated with a data source property) or left unbound

·        Cannot be associated with a hyperlink

Prerequisites

You have:

·        Added a radio button group control in a tile

·        Identified the property of the data source to be associated with the control, if you want the control to be bound

·        Identified the business anchor that references the data source

·        Switched to the required change list

Procedure

...

       1.      In the Solution Explorer, locate the tile for which you want to design the radio button group control, click the tile with the secondary mouse button, and choose View Designer.

The Tile Designer window appears.

       2.      Select the control.

The Properties panel displays the values for the radio button group control’s properties.

       3.      In the Properties panel, enter the appropriate values for the control properties.

For information on each of the properties, see Properties of a Radio Button Group Control.

       4.      If you do not need to create an event handler, continue with step 5. If you want to create an event handler, perform the following steps:

                            a.      In the Tile Designer, click the control with the secondary mouse button and choose Add Handler.

The New Event Handler dialog box appears with default values in the fields.

                            b.      In the Event field, select the event you want to use.

The following table provides information about the events.

Event Name	Description
onBoundAttributeChanged	The value of the BO attribute changes. This event occurs after a user selects a radio button control from the group.
onValueChanged2	The value of the radio button group field changes due to the value of the radio button control selection.

The onValueChanged event is not supported in this release. Use onValueChanged2 event.

                            c.      Select Edit this handler code after creation and choose OK.

                            d.      In the TODO section, enter the code you require for the event handler.

                            e.      Save the code.

       5.      Save your entries.

Result

You have defined a radio button group control by specifying the properties and event handlers. You can continue by adding radio buttons to this control. For more information, see Defining a Radio Button Control.

See also:

 

Adding Controls to a Tile