Check States for .NET MAUI CheckBox
The CheckBox enables you to define its state as Checked
, Unchecked
, or Indeterminate
.
The state is controlled through the IsChecked
(bool?
) property. You can set all states either through the UI or programmatically. The Indeterminate
state can be applied through the UI only for three-state checkboxes. IsChecked
property binding mode is TwoWay
.
Checked
state—WhenIsChecked
is set totrue
.(Default)
Unchecked
state—WhenIsChecked
is set tofalse
.Indeterminate
state—WhenIsChecked
isnull
.IsThreeState
(bool
)—Defines whether you can apply the Indeterminate state through the UI. WhenIsThreeState
istrue
, it allows the end user to go to the Indeterminate state along with the Checked and Unchecked states. By default,IsThreeState
is set tofalse
.
The following example demonstrates how to set the IsChecked
property.
Define the checked state of the CheckBox.
<telerik:RadCheckBox x:Name="checkboxIsChecked"
IsChecked="{Binding IsChecked}"
IsThreeState="True" />
Set the ViewModel.
public class ViewModel : NotifyPropertyChangedBase
{
private bool? isChecked;
public bool? IsChecked
{
get { return this.isChecked; }
set
{
if (this.isChecked != value)
{
this.isChecked = value;
OnPropertyChanged();
}
}
}
}
The image below shows the result at runtime displaying the defined Indeterminate state together with the configured StrokeWidth
and Length
properties.
Events
-
IsCheckedChanged
—Occurs when theRadCheckBox.IsChecked
property is changed. TheIsCheckedChanged
event handler receives two parameters:- The
Sender
which is of type Telerik.Maui.Controls.RadCheckBox. - and
IsCheckedChangedEventArgs
. TheIsCheckedChangedEventArgs
provides the following properties:-
NewValue
(bool?
)—Gets the new value from the CheckBox state. -
OldValue
(bool?
)—Gets the old value of the CheckBox state.
-
- The