ToggleButton.IsChecked Eigenschaft

Definition

Namespace:

System.Windows.Controls.Primitives

Assembly:

PresentationFramework.dll

Ruft ab oder legt fest, ob ToggleButton aktiviert ist oder nicht.

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)

Eigenschaftswert

Nullable<Boolean>

true, wenn ToggleButton aktiviert ist, false, wenn ToggleButton nicht aktiviert ist, andernfalls null. Der Standardwert ist false.

Attribute

TypeConverterAttribute LocalizabilityAttribute

Beispiele

Im folgenden Beispiel wird ein CheckBox Satz in einen unbestimmten Zustand erstellt.

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

Hinweise

Ein Steuerelement, das von ToggleButton erbt, bestimmt sein Verhalten, wenn diese Eigenschaft ist null.

CheckBox

Wenn die IsThreeState Eigenschaft auf true festgelegt ist, kann ein Benutzer auf einen CheckBox klicken, um drei mögliche Zustände zu wählen. In der folgenden Tabelle werden die drei Zustände eines CheckBoxbeschrieben.

Status der CheckBox	Wert von IsChecked
Aktiviert	true
Deaktiviert	false
Unbestimmt	null

Wenn IsThreeState false ist, können Sie diese Eigenschaft weiterhin programmgesteuert auf null festlegen, um die CheckBox in einen unbestimmten Zustand zu versetzen, aber der Benutzer kann nicht über die Benutzeroberfläche (UI) auf den CheckBox unbestimmten Zustand festlegen.

RadioButton

Wenn Sie diese Eigenschaft auf null für festlegen RadioButton, ist die RadioButton deaktiviert.

Verwendung von XAML-Attributen

<ObjektIsChecked ="Boolean"/>

Oder

<ObjektIsChecked ="{x:Null-Markuperweiterung}"/>

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	IsCheckedProperty
Metadateneigenschaften auf true festgelegt	BindsTwoWayByDefault