ToggleButton.IsChecked Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define se a ToggleButton está marcada.
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 da propriedade
true
se a ToggleButton estiver marcada; false se o ToggleButton estiver desmarcado; caso contrário, null
. O padrão é false
.
- Atributos
Exemplos
O exemplo a seguir cria um CheckBox definido como um estado indeterminado.
<CheckBox Name="checkBox1" IsThreeState="True"
IsChecked="{x:Null}">
A CheckBox in an indeterminate state
</CheckBox>
Comentários
Um controle que herda de ToggleButton determina seu comportamento quando essa propriedade é null
.
Caixa de Seleção
Quando a propriedade IsThreeState é definida como true, um usuário pode clicar em um CheckBox para escolher três estados possíveis. A tabela a seguir descreve os três estados de um CheckBox.
Estado do CheckBox | Valor de IsChecked |
---|---|
Verificado | true |
Desmarcada | false |
Indeterminado | null |
Se IsThreeState for falso, você ainda poderá definir essa propriedade de forma programática para null
colocar o CheckBox em um estado indeterminado, mas o usuário não poderá definir o CheckBox para o estado indeterminado por meio da interface do usuário (interface do usuário).
RadioButton
Se você definir essa propriedade como null
em um RadioButton, o RadioButton será desmarcado.
Uso do atributo XAML
<
objetoIsChecked
="Boolean"/>
-ou-
<
objectIsChecked
="{x:Null Markup Extension}"/>
Informações da propriedade Dependency
Campo identificador | IsCheckedProperty |
Propriedades de metadados definidas como true |
BindsTwoWayByDefault |