次の方法で共有


Xamarin.Forms CheckBox

Xamarin.FormsCheckBox は、チェックできる、または空のボタンの種類です。 チェックボックスがチェックされると、オンと見なされます。 チェックボックスが空の場合は、オフと見なされます。

CheckBox は、IsChecked という名前の bool プロパティを定義します。これは、CheckBox がオンになっているかどうかを示します。 また、このプロパティは、BindableProperty オブジェクトによって動作します。これは、スタイルの設定が可能であり、データ バインディングのターゲットにできることを意味します。

Note

IsChecked のバインド可能なプロパティのバインディング モードは、既定値で BindingMode.TwoWay になります。

CheckBox は、ユーザー操作を通じて、またはアプリケーションで IsChecked プロパティが設定された場合のいずれかにより、IsChecked プロパティが変わったときに発生する CheckedChanged イベントを定義します。 CheckedChanged イベントに付随する CheckedChangedEventArgs オブジェクトには、bool 型の Value という名前の単一のプロパティがあります。 イベントが発生すると、Value プロパティの値が IsChecked プロパティの新しい値に設定されます。

チェックボックスの作成

次の例は、XAML で CheckBox をインスタンス化する方法を示しています。

<CheckBox />

この XAML は、次のスクリーンショットのような結果になります。

iOS と Android での空の CheckBox のスクリーンショット

既定では、CheckBox は空です。 CheckBox は、ユーザー操作によって、または IsChecked プロパティを true に設定することによって確認できます。

<CheckBox IsChecked="true" />

この XAML は、次のスクリーンショットのような結果になります。

iOS と Android でのオンにされた CheckBox のスクリーンショット

または、コードで CheckBox を作成することもできます。

CheckBox checkBox = new CheckBox { IsChecked = true };

チェックボックスの状態の変化に対応する

ユーザー操作またはアプリケーションによる IsChecked プロパティの設定によって IsChecked プロパティが変更されると、CheckedChanged イベントが発生します。 このイベントのイベント ハンドラーを登録して、変更に応答できます。

<CheckBox CheckedChanged="OnCheckBoxCheckedChanged" />

分離コード ファイルには、CheckedChanged イベントのハンドラーが含まれます。

void OnCheckBoxCheckedChanged(object sender, CheckedChangedEventArgs e)
{
    // Perform required operation after examining e.Value
}

引数 sender は、このイベントに責任を持つ CheckBox です。 これを使用して、CheckBox オブジェクトにアクセスしたり、同じ CheckedChanged イベント ハンドラーを共有する複数の CheckBox オブジェクトを区別したりできます。

または、CheckedChanged イベントのイベント ハンドラーをコードに登録することもできます。

CheckBox checkBox = new CheckBox { ... };
checkBox.CheckedChanged += (sender, e) =>
{
    // Perform required operation after examining e.Value
};

チェックボックスのデータ バインド

CheckedChanged イベント ハンドラーは、データ バインディングとトリガーを使用して、チェックまたは空の状態の CheckBox に応答することで排除できます。

<CheckBox x:Name="checkBox" />
<Label Text="Lorem ipsum dolor sit amet, elit rutrum, enim hendrerit augue vitae praesent sed non, lorem aenean quis praesent pede.">
    <Label.Triggers>
        <DataTrigger TargetType="Label"
                     Binding="{Binding Source={x:Reference checkBox}, Path=IsChecked}"
                     Value="true">
            <Setter Property="FontAttributes"
                    Value="Italic, Bold" />
            <Setter Property="FontSize"
                    Value="Large" />
        </DataTrigger>
    </Label.Triggers>
</Label>

この例では、Label は、データ トリガーでバインディング式を使用して、CheckBoxIsChecked プロパティを監視します。 このプロパティが true になると、LabelFontAttributesFontSize のプロパティが変更されます。 IsChecked プロパティが false に戻ると、LabelFontAttributesFontSize プロパティは初期状態にリセットされます。

次のスクリーンショットでは、iOS のスクリーンショットは CheckBox が空の場合の Label の書式設定を示し、Android のスクリーンショットは CheckBox がオンになっているときの Label の書式設定を示しています。

iOS と Android でのデータ バインドされた CheckBox のスクリーンショット

トリガーの詳細については、「Xamarin.Forms のトリガー」を参照してください。

チェックボックスを無効にする

アプリケーションは、CheckBox のチェックが有効な操作ではない状態になることがあります。 このような場合は、その IsEnabled プロパティを false に設定することで、CheckBox を無効にすることができます。

チェックボックスの外観

View クラスから CheckBox が継承するプロパティに加えて、CheckBox は、その色を Color に設定する Color プロパティも定義します。

<CheckBox Color="Red" />

次のスクリーンショットは、オンになった一連の CheckBox オブジェクトを示しています。各オブジェクトの Color プロパティは個別の Color に設定されています。

iOS と Android での色付きの CheckBox のスクリーンショット

チェックボックスの表示状態

CheckBox には、CheckBox にチェックが入れられたときに視覚的な変更を開始するために使用できる IsChecked VisualState があります。

次の XAML の例は、IsChecked 状態の表示状態を定義する方法を示しています。

<CheckBox ...>
    <VisualStateManager.VisualStateGroups>
        <VisualStateGroup x:Name="CommonStates">
            <VisualState x:Name="Normal">
                <VisualState.Setters>
                    <Setter Property="Color"
                            Value="Red" />
                </VisualState.Setters>
            </VisualState>

            <VisualState x:Name="IsChecked">
                <VisualState.Setters>
                    <Setter Property="Color"
                            Value="Green" />
                </VisualState.Setters>
            </VisualState>
        </VisualStateGroup>
    </VisualStateManager.VisualStateGroups>
</CheckBox>

この例では、IsChecked VisualStateCheckBox にチェックが入っている場合、Color プロパティが緑に設定されることを指定します。 Normal VisualStateCheckBox が通常状態にある場合、Color プロパティが赤に設定されることを指定します。 したがって、全体的な効果として、CheckBox が空の場合は赤になり、チェックされている場合は緑になります。

ビジュアルの状態の詳細については、「Xamarin.Forms Visual State Manager」をご覧ください。