ToggleButton.IsChecked Propiedad

Definición

Obtiene o establece si se activa ToggleButton.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)

Valor de propiedad

Nullable<Boolean>

true si ToggleButton está activado; false si ToggleButton no está activado; de lo contrario, null.true if the ToggleButton is checked; false if the ToggleButton is unchecked; otherwise null. De manera predeterminada, es false.The default is false.

Atributos

Ejemplos

En el ejemplo siguiente se crea un CheckBox conjunto en un estado indeterminado.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>

Comentarios

Un control que hereda de ToggleButton determina su comportamiento cuando esta propiedad es null .A control that inherits from ToggleButton determines its behavior when this property is null.

CheckBoxCheckBox

Cuando la IsThreeState propiedad está establecida en true, un usuario puede hacer clic en CheckBox para elegir tres Estados posibles.When the IsThreeState property is set to true, a user can click a CheckBox to pick three possible states. En la tabla siguiente se describen los tres Estados de un CheckBox .The following table describes the three states of a CheckBox.

Estado del CheckBoxState of the CheckBox Valor de IsCheckedValue of IsChecked
ActivadaChecked true
No activadoUnchecked false
DeterminaIndeterminate null

Si IsThreeState es false, puede establecer mediante programación esta propiedad en null para colocar CheckBox en un estado indeterminado, pero el usuario no puede establecer CheckBox en el estado indeterminado a través de interfaz de usuario (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 interfaz de usuario (UI)user interface (UI).

RadioButtonRadioButton

Si establece esta propiedad en null en RadioButton , el RadioButton está desactivado.If you set this property to null on a RadioButton, the RadioButton is unchecked.

Uso de atributos XAMLXAML Attribute Usage

<objeto IsChecked de = " Boolean "/><object IsChecked="Boolean"/>

o bien-or-

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

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field IsCheckedProperty
Propiedades de metadatos establecidas en trueMetadata properties set to true BindsTwoWayByDefault

Se aplica a