Class RadioButton

Namespace: Alternet.UI

Assembly: Alternet.UI.dll

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

[ControlCategory("Common")]
public class RadioButton : ButtonBase, IBaseObject, IDisposableObject, IInputElement, ISupportInitialize, IFocusable, IWin32Window, IComponent, IDisposable, ITextProperty

Inheritance: object

BaseObject

DisposableObject

DispatcherObject

DependencyObject

UIElement

FrameworkElement

Control

CustomButton

ButtonBase

RadioButton

Implements: IBaseObject

IDisposableObject

IInputElement

ISupportInitialize

IFocusable

IWin32Window

IComponent

IDisposable

ITextProperty

Extension Methods: UixmlPortObjectExtensions.Bind(DependencyObject, DependencyProperty, Binding, object?)

Examples

Here is how to declare a RadioButton in UIXML:

<RadioButton Name="radioButton1" Margin="8" Text="Option 1.1" CheckedChanged="RadioButton_CheckedChanged" />
<RadioButton Name="radioButton2" Margin="8" Text="Option 1.2" CheckedChanged="RadioButton_CheckedChanged" />
<RadioButton Name="radioButton3" Margin="8" Text="Option 1.3" CheckedChanged="RadioButton_CheckedChanged" />

And the corresponding event handler in the code-behind:

private static void RadioButton_CheckedChanged(object? sender, EventArgs e)
{
    var text = ((Alternet.UI.RadioButton)sender).IsChecked.ToString();
    MessageBox.Show(text, string.Empty);
}

Also, a RadioButton can be created from code:

var panel2 = new StackPanel { Orientation = StackPanelOrientation.Vertical, Margin = new Thickness(5) };

panel2.Children.Add(new Alternet.UI.RadioButton() { Text = "Option 1.1", Margin = new Thickness(0, 0, 0, 5) });
panel2.Children.Add(new Alternet.UI.RadioButton() { Text = "Option 1.2", Margin = new Thickness(0, 0, 0, 5) });
panel2.Children.Add(new Alternet.UI.RadioButton() { Text = "Option 1.3", Margin = new Thickness(0, 0, 0, 5) });

Remarks

When the user selects one radio button (also known as an option button) within a group, the others clear automatically. All RadioButton controls in a given container, such as a Window, constitute a group. To create multiple groups on one window, place each group in its own container, such as a GroupBox.

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 IsChecked property to get or set the state of a RadioButton.

Examples of how a RadioButton can look on different platforms:

RadioButton on Windows

Set Text property to specify the text displayed on the control. A RadioButton, like any other Control, can be disabled by setting its Enabled property to false.

Properties

ControlKind: Returns control identifier.

IsChecked: Gets or sets a value indicating whether the control is checked.

Methods

OnCheckedChanged(EventArgs): Called when the value of the IsChecked property changes.

Events