ToggleButton.IsChecked Eigenschaft

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.

Attribute

Beispiele

Im folgenden Beispiel wird ein 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 ToggleButton erbt, bestimmt sein Verhalten, nullwenn diese Eigenschaft ist.A control that inherits from ToggleButton determines its behavior when this property is null.

CheckBoxCheckBox

Wenn die IsThreeState Eigenschaft auf true festgelegt ist, kann ein Benutzer auf CheckBox einen klicken, um drei mögliche Zustände auszuwählen.When the IsThreeState property is set to true, a user can click a CheckBox to pick three possible states. In der folgenden Tabelle werden die drei Zustände einer CheckBoxbeschrieben.The following table describes the three states of a CheckBox.

Status desCheckBoxState of the CheckBox Wert von IsCheckedValue of IsChecked
AktiviertChecked true
BenemUnchecked false
UnbestimmtenIndeterminate null

Wenn IsThreeState false ist, können Sie diese Eigenschaft weiterhin Programm gesteuert auf null festlegen, um die CheckBox in einen unbestimmten CheckBox Zustand zu versetzen, aber der Benutzer kann nicht auf den unbestimmten Zustand über Benutzeroberfläche (User Interface, UI)user interface (UI)das festlegen.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 für null einen RadioButtonauf festlegen, wird RadioButton die nicht aktiviert.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 = "{x:Null-Markuperweiterung}"/> IsChecked<object IsChecked="{x:Null Markup Extension}"/>

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field IsCheckedProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true BindsTwoWayByDefault

Gilt für: