uradiogroup (RadioGroup)
The uradiogroup widget displays a set of mutually exclusive choices as a group of
radio buttons. Uniface provides a logical widget called RadioGroup, which is mapped to uradiogroup.
For more information, see Specifying a Widget for a Field or Entity and ValRep.
| Logical Widget Name: | RadioGroup |
| Maps to Physical Widget : | RadioGroup
|
| Default definition: | RadioGroup=uradiogroup(font=label)
|
| Supported triggers: | See Triggers |
| Supported properties: | See Widget Properties |
| Use for: | String fields with a ValRep containing mutually exclusive options. |
| Supported in Grid? | No |
| Supports MSAA? : | No |
Description
Use the uradiogroup widget to display a ValRep of two or more mutually exclusive options. Selecting one option disables all other options, with each item represented by a button.
ValRep Handling
The maximum number of buttons depends on the ValRep for that widget. It is usually used for a very limited number of options.
The widget uses the ValRep list defined for the field to build up the options visible in the drop-down list. It expects a list of Value=Representation pairs and displays the representations labels for the radio buttons. If a ValRep item does not have a Representation, the Value is displayed instead. When the user selects an item, the corresponding value is selected.
For more information, see ValRep.
Triggers
- trigger detail
- trigger valueChanged—activated each time you select a new value for the field. Code any associated action in the valueChanged trigger for a radio group.
- trigger Resized
Widget Properties
| Property | Technical Name | Dynamic? |
|---|---|---|
| 3-D Effect (3d) | 3D | No |
| Alignment or Text Position (align) | Align | No |
| Attach to Window Border (attach) | Attach | Yes |
| Attach Margin (AttachMargin) | AttachMargin | Yes |
| Background Color (BackColor) | BackColor | Yes |
| Foreground Color (ForeColor) | ForeColor | Yes |
| Frame | Frame | Yes |
| Label Font (LabelFont) | LabelFont | Yes |
| Number of Columns (Columns) | Columns | Yes |
| Number of Rows (rows) | Rows | Yes |
| Value and Representation |
— |
Yes |
| Widget Font (Font) | Font | Yes |
| Transparency | Transparency | Yes |
| Popup Rectangle (PopupRect) | PopupRect | Yes |
| Inherit Colors (InheritColors) | InheritColors | Yes |
Note: The Transparency property should be set to false to ensure that the radio buttons are correctly displayed.
Character Mode
In character mode, the selected option of a radio group displays the VIEW_RADIO character. All other options display the VIEW_RADIO_OFF character. If the widget does not have enough room to display all of its options, the widget displays either the VIEW_MOREUP or VIEW_MOREDOWN character. These are displayed with the inverse of the video attributes of the widget. The video attributes of the widget are set by the $RADIO_BUTTON assignment file setting.
