ToggleButton.IsChecked Property

Definition

Gets or sets whether the ToggleButton is checked.

public:
 property Nullable<bool> IsChecked { Nullable<bool> get(); void set(Nullable<bool> value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.NullableBoolConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public bool? IsChecked { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.NullableBoolConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.IsChecked : Nullable<bool> with get, set
Public Property IsChecked As Nullable(Of Boolean)

Property Value

true if the ToggleButton is checked; false if the ToggleButton is unchecked; otherwise null. The default is false.

Attributes

Examples

The following example creates a CheckBox set to an indeterminate state.

<CheckBox Name="checkBox1" IsThreeState="True" 
          IsChecked="{x:Null}">
  A CheckBox in an indeterminate state
</CheckBox>

Remarks

A control that inherits from ToggleButton determines its behavior when this property is null.

CheckBox

When the IsThreeState property is set to true, a user can click a CheckBox to pick three possible states. The following table describes the three states of a CheckBox.

State of the CheckBox Value of IsChecked
Checked true
Unchecked false
Indeterminate null

If IsThreeState is false, you can still programmatically set this property to null to put the CheckBox in an indeterminate state, but the user cannot set the CheckBox to the indeterminate state through the user interface (UI).

RadioButton

If you set this property to null on a RadioButton, the RadioButton is unchecked.

XAML Attribute Usage

<object IsChecked="Boolean"/>

-or-

<object IsChecked="{x:Null Markup Extension}"/>

Dependency Property Information

Identifier field IsCheckedProperty
Metadata properties set to true BindsTwoWayByDefault

Applies to