ToggleButton.IsChecked Propriété

Définition

Obtient ou définit si le ToggleButton est activé.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 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)

Valeur de propriété

Nullable<Boolean>

true si le ToggleButton est activé ; false si le ToggleButton est désactivé ; sinon null.true if the ToggleButton is checked; false if the ToggleButton is unchecked; otherwise null. La valeur par défaut est false.The default is false.

Attributs

Exemples

L’exemple suivant crée un CheckBox défini sur un état indéterminé.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>

Remarques

Un contrôle qui hérite de ToggleButton détermine son comportement lorsque cette propriété est null .A control that inherits from ToggleButton determines its behavior when this property is null.

Case à cocherCheckBox

Lorsque la IsThreeState propriété est définie sur true, un utilisateur peut cliquer sur un CheckBox pour choisir trois États possibles.When the IsThreeState property is set to true, a user can click a CheckBox to pick three possible states. Le tableau suivant décrit les trois États d’un CheckBox .The following table describes the three states of a CheckBox.

État du CheckBoxState of the CheckBox Valeur de IsCheckedValue of IsChecked
ActivéeChecked true
DésactivéUnchecked false
DéterminéeIndeterminate null

Si IsThreeState a la valeur false, vous pouvez toujours définir cette propriété par programmation sur null pour placer le CheckBox dans un état indéterminé, mais l’utilisateur ne peut pas affecter CheckBox à l’état indéterminé par le biais de interface utilisateur (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 interface utilisateur (UI)user interface (UI).

RadioButtonRadioButton

Si vous définissez cette propriété null sur sur un RadioButton , la RadioButton est désactivée.If you set this property to null on a RadioButton, the RadioButton is unchecked.

Utilisation d'attributs XAMLXAML Attribute Usage

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

- ou --or-

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

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field IsCheckedProperty
Propriétés de métadonnées définies sur trueMetadata properties set to true BindsTwoWayByDefault

S’applique à