ToggleButton.IsChecked プロパティ

定義

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)

プロパティ値

ToggleButton がチェックされているかどうかを true します。ToggleButton がオフの場合は false。それ以外の場合は null。 既定値は falseです。

属性

次の例では、不確定状態に設定された CheckBox を作成します。

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

注釈

ToggleButton から継承するコントロールは、このプロパティが nullされたときの動作を決定します。

CheckBox

IsThreeState プロパティが true に設定されている場合、ユーザーは CheckBox をクリックして 3 つの状態を選択できます。 次の表では、CheckBoxの 3 つの状態について説明します。

CheckBox の状態 IsChecked の値
チェック true
オフ false
不確定 null

IsThreeState が false の場合でも、プログラムによってこのプロパティを null に設定して、CheckBox を不確定な状態にすることができますが、ユーザーはユーザー インターフェイス (UI) を使用して CheckBox を不確定状態に設定することはできません。

RadioButton

このプロパティを RadioButtonnull に設定すると、RadioButton はオフになります。

XAML 属性の使用法

< オブジェクトIsChecked="Boolean"/>

-又は-

< オブジェクトIsChecked="{x:Null マークアップ拡張}"/>

依存関係プロパティ情報

識別子フィールド IsCheckedProperty
true に設定されたメタデータ プロパティ BindsTwoWayByDefault

適用対象