ToggleButton.IsChecked Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 |