ToggleButton.IsChecked Propriedade

Definição

Namespace:

System.Windows.Controls.Primitives

Assembly:

PresentationFramework.dll

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

Nullable<Boolean>

true se a ToggleButton estiver marcada; false se o ToggleButton estiver desmarcado; caso contrário, null. O padrão é false.

Atributos

TypeConverterAttribute LocalizabilityAttribute

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