ToggleButton.IsChecked プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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)
プロパティ値
true
ToggleButtonがチェックされている場合は false、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
このプロパティをRadioButtonのnullに設定すると、RadioButtonはオフになります。
XAML 属性の使用法
<
objectIsChecked="Boolean"/>
-又は-
<
objectIsChecked="{x:Null マークアップ拡張}"/>
依存関係プロパティ情報
| 品目 | 価値 |
|---|---|
| 識別子フィールド | IsCheckedProperty |
に設定されたメタデータ プロパティ true |
BindsTwoWayByDefault |