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 the user selects one option button (also known as a radio button) 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 have a similar function: they offer choices a user can select or clear. The difference is that multiple CheckBox controls can be selected at the same time, but option buttons are mutually exclusive.

Use the Checked property to get or set the state of a RadioButton. The option button's appearance can be altered to appear as a toggle-style button or as a standard option button by setting the Appearance property.

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



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

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


The RadioButton icon and label can be positioned anywhere in relation to each other. They are set with the CheckAlign and TextAlign properties, respectively.


JavaScript Widget


Class name


Theme appearance

"radiobutton", see Themes.

Child components

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

Source code

Last updated