RadioButton

Enables the user to select a single option from a group of choices when paired with other RadioButton controls.

The RadioButton control can display text, an Image, or both.

When a user selects one RadioButton within a group, the others clear automatically. All RadioButton controls in a given container, such as a Form, constitute a group. To create multiple groups on one form, place each group in its own container, such as a GroupBox or Panel control.

RadioButton and CheckBox controls serve similar functions: they offer choices users can select or clear. The key difference is that multiple CheckBox controls can be selected simultaneously, while RadioButtons are mutually exclusive.

Use the Checked property to get or set the state of a RadioButton. The control's appearance can be set to a toggle-style button or standard option button using the Appearance property.

For a full list of properties, methods and events see the API documentation.

Features

Selection

When placed into a container, only one RadioButton control can be selected at a time.

RadioButton control demonstrating mutually exclusive selection

If the AutoCheck property is set to false, more than one radio button might be selected within the container.

Alignment

The RadioButton icon and label can be positioned anywhere in relation to each other using the CheckAlign and TextAlign properties.

RadioButton control showing various alignment options

Advanced

JavaScript Widget

Item
Description

Class name

"wisej.web.RadioButton"

Theme appearance

"radiobutton", see Themes.

Child components

"icon" is the radiobutton icon, "label" is the text. See JavaScript.

Last updated

Was this helpful?