CheckBox クラス
Windows チェック ボックスを表します。
この型のすべてのメンバの一覧については、CheckBox メンバ を参照してください。
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ButtonBase
System.Windows.Forms.CheckBox
Public Class CheckBox
Inherits ButtonBase
[C#]
public class CheckBox : ButtonBase
[C++]
public __gc class CheckBox : public ButtonBase
[JScript]
public class CheckBox extends ButtonBase
スレッドセーフ
この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。
解説
CheckBox を使用してユーザーが true/false、yes/no などのオプションを使用できるようにします。チェック ボックス コントロールはイメージ、テキスト、またはその両方を表示できます。
CheckBox コントロールと RadioButton コントロールには似た機能があり、ユーザーがオプションのリストから選択できるようにします。 CheckBox コントロールは、複数のオプションを組み合わせて選択できるようにします。これに対して RadioButton コントロールは、複数のオプションから 1 つだけを選択できるようにします。
Appearance プロパティは、チェック ボックスを通常のチェック ボックスで表示するのか、またはボタンで表示するのかを決定します。
ThreeState プロパティは、コントロールで 2 ステートと 3 ステートのどちらをサポートするのかを決定します。 Checked プロパティを使用して、2 ステートのチェック ボックス コントロールの値を取得または設定し、 CheckState プロパティを使用して、3 ステートのチェック ボックス コントロールの値を取得または設定します。
メモ ThreeState プロパティが true に設定されている場合、 Checked プロパティは、チェックされた状態と不確定状態のどちらであるかを示す true を返します。
FlatStyle プロパティは、コントロールのスタイルと外観を決定します。 FlatStyle プロパティが FlatStyle.System に設定されている場合は、ユーザーが使用しているオペレーティング システムによってコントロールの外観が決定されます。
メモ FlatStyle プロパティが FlatStyle.System に設定されていると、 CheckAlign プロパティの値は無視され、コントロールは ContentAlignment.MiddleLeft 値または ContentAlignment.MiddleRight 値を使用して整列および表示されます。 CheckAlign プロパティの値が右揃えの 1 つに設定されている場合、コントロールは ContentAlignment.MiddleRight 値を使用して整列および表示されます。それ以外の場合は、 ContentAlignment.MiddleLeft 値が使用されます。
不確定状態とは、次のような状態です。 RichTextBox で選択したテキストを太字にするかどうかを決定するチェック ボックスがあるとします。テキストを選択してチェック ボックスをクリックすると、選択したテキストが太字になります。同様に、テキストを選択すると、選択したテキストが太字かどうかをチェック ボックスが表示します。選択したテキストに太字と標準の両方のテキストがある場合は、チェック ボックスは不確定状態を表します。
使用例
CheckBox を作成および初期化し、トグル ボタンの外観を生成する例を次に示します。 AutoCheck を false に設定し、トグル ボタンを Form に追加します。
Public Sub InstantiateMyCheckBox()
' Create and initialize a CheckBox.
Dim checkBox1 As New CheckBox()
' Make the check box control appear as a toggle button.
checkBox1.Appearance = Appearance.Button
' Turn off the update of the display on the click of the control.
checkBox1.AutoCheck = False
' Add the check box control to the form.
Controls.Add(checkBox1)
End Sub 'InstantiateMyCheckBox
[C#]
public void InstantiateMyCheckBox()
{
// Create and initialize a CheckBox.
CheckBox checkBox1 = new CheckBox();
// Make the check box control appear as a toggle button.
checkBox1.Appearance = Appearance.Button;
// Turn off the update of the display on the click of the control.
checkBox1.AutoCheck = false;
// Add the check box control to the form.
Controls.Add(checkBox1);
}
[C++]
public:
void InstantiateMyCheckBox() {
// Create and initialize a CheckBox.
CheckBox __gc *checkBox1 = new CheckBox();
// Make the check box control appear as a toggle button.
checkBox1->Appearance = Appearance::Button;
// Turn off the update of the display on the click of the control.
checkBox1->AutoCheck = false;
// Add the check box control to the form.
this->Controls->Add(checkBox1);
};
[JScript]
public function InstantiateMyCheckBox()
{
// Create and initialize a CheckBox.
var checkBox1 : CheckBox = new CheckBox();
// Make the check box control appear as a toggle button.
checkBox1.Appearance = Appearance.Button;
// Turn off the update of the display on the click of the control.
checkBox1.AutoCheck = false;
// Add the check box control to the form.
Controls.Add(checkBox1);
}
必要条件
名前空間: System.Windows.Forms
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)