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>

備註

當這個屬性為 null 時，繼承自 ToggleButton 的控制項會決定其行為。

CheckBox

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

的狀態 CheckBox	IsChecked 的值
已檢查	true
未核取	false
定	null

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

RadioButton

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

XAML Attribute Usage

<物件IsChecked="Boolean"/>

-或-

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

相依性屬性資訊

識別碼欄位	IsCheckedProperty
中繼資料屬性設定為 true	BindsTwoWayByDefault