XAML-チェックボックス

CheckBoxは、ユーザーが選択（チェック）またはクリア（チェック解除）できるコントロールです。アプリケーションに適用する設定のリストなど、ユーザーが選択できるオプションのリストを提供します。チェックボックスクラスの階層的な継承は次のとおりです-

チェックボックス階層

プロパティ

以下に、CheckBoxの最も一般的に使用されるプロパティを示します。

Sr.No.	Property & Description
1	Background コントロールの背景を提供するブラシを取得または設定します。（Controlから継承）
2	BorderBrush コントロールの境界線の塗りつぶしを記述するブラシを取得または設定します。（Controlから継承）
3	BorderThickness コントロールの境界線の太さを取得または設定します。（Controlから継承）
4	Content ContentControlのコンテンツを取得または設定します。（ContentControlから継承されます）
5	ClickMode デバイスの動作に関して、Clickイベントがいつ発生するかを示す値を取得または設定します。（ButtonBaseから継承）
6	ContentTemplate ContentControlのコンテンツを表示するために使用されるデータテンプレートを取得または設定します。（ContentControlから継承されます）
7	FontFamily コントロール内のテキストの表示に使用されるフォントを取得または設定します。（Controlから継承）
8	FontSize このコントロール内のテキストのサイズを取得または設定します。（Controlから継承）
9	FontStyle テキストがレンダリングされるスタイルを取得または設定します。（Controlから継承）
10	FontWeight 指定したフォントの太さを取得または設定します。（Controlから継承）
11	Foreground 前景色を説明するブラシを取得または設定します。（Controlから継承）
12	Height FrameworkElementの推奨される高さを取得または設定します。（FrameworkElementから継承されます）
13	HorizontalAlignment FrameworkElementがパネルやアイテムコントロールなどのレイアウトの親で構成されるときにFrameworkElementに適用される水平方向の配置特性を取得または設定します。（FrameworkElementから継承されます）
14	IsChecked ToggleButtonがチェックされているかどうかを取得または設定します。（ToggleButtonから継承）
15	IsEnabled ユーザーがコントロールを操作できるかどうかを示す値を取得または設定します。（Controlから継承）
16	IsPressed ButtonBaseが現在押された状態にあるかどうかを示す値を取得します。（ButtonBaseから継承）
17	IsThreeState コントロールが3つの状態をサポートするかどうかを示す値を取得または設定します。（ToggleButtonから継承）
18	Margin FrameworkElementの外側のマージンを取得または設定します。（FrameworkElementから継承されます）
19	Name オブジェクトの識別名を取得または設定します。 XAMLプロセッサがXAMLマークアップからオブジェクトツリーを作成するとき、ランタイムコードはこの名前でXAMLで宣言されたオブジェクトを参照できます。（FrameworkElementから継承されます）
20	Opacity オブジェクトの不透明度を取得または設定します。（UIElementから継承）
21	Resources ローカルに定義されたリソースディクショナリを取得します。 XAMLでは、リソース項目をframeworkElementの子オブジェクト要素として確立できます。 XAMLの暗黙的なコレクション構文によるResourcesプロパティ要素。（FrameworkElementから継承されます）
22	Style レイアウトおよびレンダリング中にこのオブジェクトに適用されるインスタンススタイルを取得または設定します。（FrameworkElementから継承されます）
23	Template コントロールテンプレートを取得または設定します。コントロールテンプレートは、UIのコントロールの視覚的な外観を定義し、XAMLマークアップで定義されます。（Controlから継承）
24	VerticalAlignment FrameworkElementがパネルや項目コントロールなどの親オブジェクトで構成されるときにFrameworkElementに適用される垂直方向の配置特性を取得または設定します。（FrameworkElementから継承されます）
25	Visibility UIElementの可視性を取得または設定します。表示されないUIElementはレンダリングされず、目的のサイズをレイアウトに伝えません。（UIElementから継承）
26	Width FrameworkElementの幅を取得または設定します。（FrameworkElementから継承されます）

方法

以下に、CheckBoxで一般的に使用されるメソッドを示します。

Sr.No.	Method & Description
1	ClearValue 依存関係プロパティのローカル値をクリアします。（DependencyObjectから継承）
2	FindName 指定された識別子名を持つオブジェクトを取得します。（FrameworkElementから継承されます）
3	OnApplyTemplate アプリケーションコードまたは内部プロセス（再構築レイアウトパスなど）がApplyTemplateを呼び出すたびに呼び出されます。最も簡単に言えば、これは、UI要素がアプリに表示される直前にメソッドが呼び出されることを意味します。このメソッドをオーバーライドして、クラスのデフォルトのテンプレート後ロジックに影響を与えます。（FrameworkElementから継承されます）
4	OnContentChanged Contentプロパティの値が変更されたときに呼び出されます。（ContentControlから継承されます）
5	OnDragEnter DragEnterイベントが発生する前に呼び出されます。（Controlから継承）
6	OnDragLeave DragLeaveイベントが発生する前に呼び出されます。（Controlから継承）
7	OnDragOver DragOverイベントが発生する前に呼び出されます。（Controlから継承）
8	OnDrop Dropイベントが発生する前に呼び出されます。（Controlから継承）
9	OnGotFocus GotFocusイベントが発生する前に呼び出されます。（Controlから継承）
10	OnKeyDown KeyDownイベントが発生する前に呼び出されます。（Controlから継承）
11	OnKeyUp KeyUpイベントが発生する前に呼び出されます。（Controlから継承）
12	OnLostFocus LostFocusイベントが発生する前に呼び出されます。（Controlから継承）
13	OnToggle ToggleButtonがトグル刺激を受け取ると呼び出されます。（ToggleButtonから継承）
14	SetBinding 提供されたバインディングオブジェクトを使用して、FrameworkElementにバインディングをアタッチします。（FrameworkElementから継承されます）

イベント

以下に、CheckBoxの一般的に使用されるイベントを示します。

Sr.No.	Event & Description
1	Checked ToggleButtonがチェックされたときに発生します。（ToggleButtonから継承）
2	Click ボタンコントロールがクリックされたときに発生します。（ButtonBaseから継承）
3	DataContextChanged FrameworkElementの値が発生したときに発生します。 DataContextプロパティが変更されました。（FrameworkElementから継承されます）
4	DragEnter 入力システムが、この要素をターゲットとして基になるドラッグイベントを報告したときに発生します。（UIElementから継承）
5	DragLeave 入力システムが、この要素を起点として基本的なドラッグイベントを報告したときに発生します。（UIElementから継承）
6	DragOver 入力システムが潜在的なドロップターゲットとしてこの要素を持つ基本的なドラッグイベントを報告するときに発生します。（UIElementから継承）
7	DragStarting ドラッグ操作が開始されたときに発生します。（UIElementから継承）
8	GotFocus UIElementがフォーカスを受け取ったときに発生します。（UIElementから継承）
9	Holding この要素のヒットテスト領域上で未処理のホールド操作が発生すると発生します。（UIElementから継承）
10	Intermediate ToggleButtonの状態が不確定状態に切り替えられたときに発生します。（ToggleButtonから継承）
11	IsEnabledChanged IsEnabledプロパティが変更されたときに発生します。（Controlから継承）
12	KeyDown UIElementにフォーカスがあるときにキーボードキーが押されると発生します。（UIElementから継承）
13	KeyUp UIElementにフォーカスがあるときにキーボードキーが離されると発生します。（UIElementから継承）
14	LostFocus UIElementがフォーカスを失ったときに発生します。（UIElementから継承）
15	SizeChanged ActualHeightまたはActualWidthプロパティがFrameworkElementの値を変更したときに発生します。（FrameworkElementから継承されます）
16	Unchecked ToggleButtonのチェックが解除されたときに発生します。（ToggleButtonから継承）

例

次の例には、2つのチェックボックスが含まれています。最初のチェックボックスには、オンまたはオフの2つの状態があります。 2番目のチェックボックスには、チェック済み、未チェック、および中間状態の3つの状態があります。両方のチェックボックスは、チェック済み、未チェック、および中間イベントに基づいてメッセージを表示します。

これは、いくつかのプロパティとイベントで2つのチェックボックスが作成されたXAMLコードです。

<Window x:Class = "XAMLCheckBox.MainWindow"
   xmlns = "http://schemas.microsoft.com/winfx/2006/xaml/presentation"
   xmlns:x = "http://schemas.microsoft.com/winfx/2006/xaml"
   Title = "MainWindow" Height = "350" Width = "604">

   <Grid>
      <StackPanel Orientation = "Vertical" >
         <CheckBox x:Name = "cb1"
            Content = "2 state CheckBox"
            Checked = "HandleCheck"
            Unchecked = "HandleUnchecked"
            Margin = "10"/>

         <TextBlock x:Name = "text1" Margin = "10"/>

         <CheckBox x:Name = "cb2"
            Content = "3 state CheckBox"
            IsThreeState = "True"
            Indeterminate = "HandleThirdState"
            Checked = "HandleCheck"
            Unchecked = "HandleUnchecked"
            Margin = "10"/>

         <TextBlock x:Name = "text2" Margin = "10"/>
      </StackPanel>
   </Grid>

</Window>

ここに異なるイベントのC＃での実装があります-

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;

namespace XAMLCheckBox {
  ///<summary>
     ///Interaction logic for MainWindow.xaml
  ///</summary>
    public partial class MainWindow : Window {
      public MainWindow() {
         InitializeComponent();
      }
      private void HandleCheck(object sender, RoutedEventArgs e) {
         CheckBox cb = sender as CheckBox;

         if (cb.Name == "cb1") {
            text1.Text = "2 state CheckBox is checked.";
         } else {
            text2.Text = "3 state CheckBox is checked.";
         }
      }
      private void HandleUnchecked(object sender, RoutedEventArgs e) {
         CheckBox cb = sender as CheckBox;

         if (cb.Name == "cb1") {
            text1.Text = "2 state CheckBox is unchecked.";
         } else {
            text2.Text = "3 state CheckBox is unchecked.";
         }
      }
      private void HandleThirdState(object sender, RoutedEventArgs e) {
         CheckBox cb = sender as CheckBox;
         text2.Text = "3 state CheckBox is in indeterminate state.";
      }
   }
}

上記のコードをコンパイルして実行すると、次の出力が生成されます-

チェックボックス出力

上記のサンプルコードを実行し、他のプロパティやイベントを試すことをお勧めします

Xaml-checkbox

目次

XAML-チェックボックス

プロパティ

方法

イベント

例