The RadioButton control is used to allow the user to select an option, usually from group of RadioButtons.
The standard RadioButton has the following properties:
General
- Name: The name of the control
- Text: Used to set the text on the control
- Bind to Database Field: Used to map the control to a database field
- Enabled (checkbox): Specifies whether the control is initially enabled or not
- Visible (checkbox): Specifies whether the control is initially visible or not
- Tab stop (checkbox): It must be enabled in order for the control to be included in the tabbing sequence
- Tab Order: Sets the tab order for the control
- Comment: Allows you to add details of the control use, which will be output to any documentation produced
- OnAction: Allows you to define a function to run when the control's Events are triggered. Click Clear to remove this function.
Appearance
- Style: Allows you to select a style defined in the Style Editor
- Font: Allows you to define the font used for the text
- Tooltip: The text to be displayed when you hover the mouse over the control
- Background Colour: Allows you to set the background colour of the control
- Foreground Colour: Allows you to set the text colour
- Is right-to-left: Inverts the writing direction allowing you to type from the right to the left
Radio Button
- Alignment: The position of the radio button within the control (Left, Center or Right)
- Checked Value: The value returned upon querying the control when its checked
- Checked (checkbox): Allows you to specify whether or not the control will be checked when first shown (unchecked by default).
Example: The RadioButton control is used with several other RadioButton controls, so the agent is able to select a single option as the RadioButton control will only allow a one of the controls to be checked at a given time.
Where you need to provide several groups of RadioButton options these need to be placed inside a container object such as a GroupBox or Panel, for example:
