Partilhar via


ToggleButton.IsChecked Propriedade

Definição

Obtém ou define se a verificação 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 o ToggleButton for verificado; false se o ToggleButton estiver desmarcado; caso contrário null. O padrão é false.

Atributos

Exemplos

O exemplo a seguir cria um CheckBox conjunto para 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 IsThreeState propriedade é 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 estado em um estado indeterminado, mas o usuário não pode definir o CheckBox estado indeterminado por meio da interface do usuário (interface do usuário).

RadioButton

Se você definir essa propriedade como null em um RadioButton, ela RadioButton será desmarcada.

Uso do atributo XAML

< ObjetoIsChecked="Boolean"/>

-ou-

< ObjetoIsChecked="{x:Extensão de marcação nula}"/>

Informações da propriedade Dependency

Item Valor
Campo identificador IsCheckedProperty
Propriedades de metadados definidas como true BindsTwoWayByDefault

Aplica-se a