Teilen über


ToggleButton.IsChecked Eigenschaft

Definition

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

true, wenn die ToggleButton überprüft wird; false, wenn der ToggleButton deaktiviert ist; andernfalls null. Der Standardwert ist false.

Attribute

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

Gilt für: