ToggleButton.IsChecked Propriedade

Definição

Obtém ou define se o ToggleButton está assinalado.

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 Propriedade

true se o ToggleButton estiver marcado; falso se o ToggleButton estiver desmarcado; caso contrário null. A predefinição é false.

Atributos

Exemplos

O exemplo seguinte cria um CheckBox conjunto para um estado indeterminado.

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

Observações

Um controlo que herda de ToggleButton determina o seu comportamento quando esta propriedade é null.

Caixa de seleção

Quando a IsThreeState propriedade está definida como verdadeira, o utilizador pode clicar em a CheckBox para escolher três estados possíveis. A tabela seguinte descreve os três estados de um CheckBox.

Estado do CheckBox Valor de IsChecked
Verificado true
Não verificado false
Indeterminado null

Se IsThreeState for falso, pode ainda definir programaticamente esta propriedade para null colocar o CheckBox num estado indeterminado, mas o utilizador não pode definir o CheckBox estado indeterminado através da interface do utilizador (UI).

RadioButton

Se definir esta propriedade como null em um RadioButton, o RadioButton não está marcado.

Uso de atributos XAML

< ObjetoIsChecked="Boolean"/>

-ou-

< ObjetoIsChecked="{x:Extensão de Marcação Nula}"/>

Informação de Propriedade de Dependência

Número Value
Campo identificador IsCheckedProperty
Propriedades dos metadados definidas como true BindsTwoWayByDefault

Aplica-se a