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 标记扩展}”/>

Dependency 属性信息

标识符字段	IsCheckedProperty
设置为 true 的元数据属性	BindsTwoWayByDefault