ToggleButton.IsChecked ToggleButton.IsChecked ToggleButton.IsChecked ToggleButton.IsChecked Property

Definition

Ruft ab oder legt fest, ob ToggleButton aktiviert ist oder nicht.Gets or sets whether the ToggleButton is checked.

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 Nullable<bool> IsChecked { get; set; }
member this.IsChecked : Nullable<bool> with get, set
Public Property IsChecked As Nullable(Of Boolean)

Eigenschaftswert

true, wenn ToggleButton aktiviert ist, false, wenn ToggleButton nicht aktiviert ist, andernfalls null.true if the ToggleButton is checked; false if the ToggleButton is unchecked; otherwise null. Die Standardeinstellung ist false.The default is false.

Beispiele

Das folgende Beispiel erstellt eine CheckBox auf einen unbestimmten Zustand festgelegt.The following example creates a CheckBox set to an indeterminate state.

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

Hinweise

Ein Steuerelement, das von erbt ToggleButton bestimmt das Verhalten, wenn diese Eigenschaft ist null.A control that inherits from ToggleButton determines its behavior when this property is null.

CheckBoxCheckBox

Wenn die IsThreeState -Eigenschaftensatz auf "true", ein Benutzer klicken kann eine CheckBox zu drei möglichen Zuständen umschalten.When the IsThreeState property is set to true, a user can click a CheckBox to pick three possible states. Die folgende Tabelle beschreibt die drei Zustände einer CheckBox.The following table describes the three states of a CheckBox.

Status der CheckBoxState of the CheckBox Wert von IsCheckedValue of IsChecked
AktiviertChecked true
deaktiviertUnchecked false
UnbestimmtIndeterminate null

Wenn IsThreeState ist "false", Sie können diese Eigenschaft immer noch programmgesteuert festlegen, um null einzufügenden der CheckBox in einem unbestimmten Zustand befindet, aber der Benutzer kann nicht festgelegt. die CheckBox in den unbestimmten Zustand über die Benutzeroberfläche (User Interface, UI)user interface (UI).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 Benutzeroberfläche (User Interface, UI)user interface (UI).

RadioButtonRadioButton

Wenn Sie diese Eigenschaft auf null auf eine RadioButton, RadioButton deaktiviert ist.If you set this property to null on a RadioButton, the RadioButton is unchecked.

Verwendung von XAML-AttributenXAML Attribute Usage

<Objekt IsChecked= "Boolean" / ><object IsChecked="Boolean"/>

- oder - -or-

<Objekt IsChecked= "{X: Null Markup Extension}" / ><object IsChecked="{x:Null Markup Extension}"/>

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field IsCheckedProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true BindsTwoWayByDefault

Gilt für: