ToggleButton.IsChecked 屬性

定義

命名空間:

System.Windows.Controls.Primitives

組件:

PresentationFramework.dll

取得或設定是否檢查 ToggleButton。

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)

屬性值

Nullable<Boolean>

如果核取 ToggleButton，true;如果未核取 ToggleButton，則為 false;否則 null。 預設值為 false。

屬性

TypeConverterAttribute LocalizabilityAttribute

範例

下列範例會建立 CheckBox 設定為不確定狀態。

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

備註

繼承自 ToggleButton 的控件會在此屬性 null時決定其行為。

CheckBox

當 IsThreeState 屬性設定為 true 時，使用者可以按兩下 CheckBox 來挑選三個可能的狀態。 下表描述 CheckBox的三種狀態。

CheckBox 的狀態	IsChecked 值
檢查	true
猖獗	false
定	null

如果 IsThreeState 為 false，您仍然可以以程式設計方式將此屬性設定為 null，以將 CheckBox 置於不確定狀態，但使用者無法透過使用者介面 （UI） 將 CheckBox 設定為不確定狀態。

RadioButton

如果您將此屬性設定為 RadioButton上的 null，則會取消核取 RadioButton。

XAML 屬性使用方式

< 物件IsChecked=“Boolean”/>

-或-

< 物件IsChecked=“{x：Null 標記延伸}”/>

相依性屬性資訊

標識元欄位	IsCheckedProperty
設定為 true 的元數據屬性	BindsTwoWayByDefault