ToggleButton.IsChecked Eigenschaft

Definition

Namespace:

System.Windows.Controls.Primitives

Assembly:

PresentationFramework.dll

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

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 die ToggleButton überprüft wird; false, wenn der ToggleButton deaktiviert ist; andernfalls null. Der Standardwert ist false.

Attribute

TypeConverterAttribute LocalizabilityAttribute

Beispiele

Im folgenden Beispiel wird ein CheckBox erstellt, der auf einen unbestimmten Zustand festgelegt ist.

<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 nullist.

CheckBox

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

Zustand der CheckBox	Wert von IsChecked
Geprüft	true
Unkontrolliert	false
Unbestimmt	null

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

RadioButton

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

XAML-Attributverwendung

< ObjektIsChecked="Boolean"/>

-oder-

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

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	IsCheckedProperty
Auf true festgelegte Metadateneigenschaften	BindsTwoWayByDefault