ToggleButton.IsChecked Property

May 11, 2014

Gets or sets whether the ToggleButton is checked.

Namespace:  System.Windows.Controls.Primitives
Assembly:  System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.

[TypeConverterAttribute(typeof(NullableBoolConverter))]
public Nullable<bool> IsChecked { get; set; }
<togglebutton IsChecked="bool"/>
-or-
<togglebutton IsChecked="{x:Null}"/>

XAML Values

togglebutton

A literal ToggleButton, or a derived type such as CheckBox or RadioButton.

Property Value

Type: System.Nullable<Boolean>
true if the ToggleButton is checked; false if the ToggleButton is unchecked; otherwise null. The default is false.

Dependency property identifier field: IsCheckedProperty

A control that inherits from ToggleButton determines its behavior when this property is null. In XAML, set the IsChecked property to the empty string ("") to display the indeterminate state. In code, you can set this property to null.

CheckBox

When the IsThreeState property is set to true, a user can tap 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.

RadioButton

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

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft