ToggleButton.IsChecked Proprietà

Definizione

Spazio dei nomi:

System.Windows.Controls.Primitives

Assembly:

PresentationFramework.dll

Ottiene o imposta un valore che indica se la ToggleButton è selezionata.

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)

Valore della proprietà

Nullable<Boolean>

true se la ToggleButton è selezionata; false se il ToggleButton è deselezionato; in caso contrario, null. Il valore predefinito è false.

Attributi

TypeConverterAttribute LocalizabilityAttribute

Esempio

Nell'esempio seguente viene creato un CheckBox impostato su uno stato indeterminato.

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

Commenti

Un controllo che eredita da ToggleButton determina il comportamento quando questa proprietà è null.

CheckBox

Quando la proprietà IsThreeState è impostata su true, un utente può fare clic su un CheckBox per selezionare tre stati possibili. Nella tabella seguente vengono descritti i tre stati di un CheckBox.

Stato del CheckBox	Valore di IsChecked
Quadrettato	true
Deselezionata	false
Indeterminato	null

Se IsThreeState è false, è comunque possibile impostare questa proprietà a livello di codice su null per inserire il CheckBox in uno stato indeterminato, ma l'utente non può impostare il CheckBox sullo stato indeterminato tramite l'interfaccia utente.

RadioButton

Se si imposta questa proprietà su null in un RadioButton, il RadioButton è deselezionato.

Utilizzo degli attributi XAML

< oggettoIsChecked="Boolean"/>

-o-

< oggettoIsChecked="{x:Null Markup Extension}"/>

Informazioni sulle proprietà di dipendenza

Campo Identificatore	IsCheckedProperty
Proprietà dei metadati impostate su true	BindsTwoWayByDefault