ToggleButton.IsChecked Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Controls.Primitives

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia, czy ToggleButton jest zaznaczone.

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)

Wartość właściwości

Nullable<Boolean>

true, czy ToggleButton jest zaznaczone; false, jeśli ToggleButton jest niezaznaczone; w przeciwnym razie null. Wartość domyślna to false.

Atrybuty

TypeConverterAttribute LocalizabilityAttribute

Przykłady

W poniższym przykładzie zostanie utworzona CheckBox ustawiona na nieokreślony stan.

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

Uwagi

Kontrolka dziedziczona po ToggleButton określa jego zachowanie, gdy ta właściwość jest null.

Pole wyboru

Gdy właściwość IsThreeState ma wartość true, użytkownik może kliknąć CheckBox, aby wybrać trzy możliwe stany. W poniższej tabeli opisano trzy stany CheckBox.

Stan CheckBox	Wartość IsChecked
Sprawdzane	true
Niezaznaczone	false
Nieokreślony	null

Jeśli IsThreeState ma wartość false, nadal można programowo ustawić tę właściwość, aby null umieścić CheckBox w stanie nieokreślonym, ale użytkownik nie może ustawić CheckBox na nieokreślony stan za pomocą interfejsu użytkownika.

Przycisk radiowy

Jeśli ustawisz tę właściwość na wartość null w RadioButton, RadioButton zostanie niezaznaczone.

Użycie atrybutu XAML

< obiektIsChecked="Boolean"/>

-lub-

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

Informacje o właściwości zależności

Pole identyfikatora	IsCheckedProperty
Właściwości metadanych ustawione na true	BindsTwoWayByDefault