CheckBox クラス (System.Windows.Forms)

すべて縮小

言語フィルタ

このページは次のバージョンについて記述しています。

Microsoft Visual Studio 2008/.NET Framework 3.5

その他のバージョンについては、以下の情報を参照してください。

.NET Framework クラスライブラリ

CheckBox クラス

更新 : 2007 年 11 月

Windows CheckBox を表します。

名前空間 : System.Windows.Forms
アセンブリ : System.Windows.Forms (System.Windows.Forms.dll 内)

構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<DefaultBindingPropertyAttribute("CheckState")> _
Public Class CheckBox _
    Inherits ButtonBase

Visual Basic (使用法)

Dim instance As CheckBox

[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[DefaultBindingPropertyAttribute("CheckState")]
public class CheckBox : ButtonBase

Visual C++

[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
[DefaultBindingPropertyAttribute(L"CheckState")]
public ref class CheckBox : public ButtonBase

/** @attribute ComVisibleAttribute(true) */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
/** @attribute DefaultBindingPropertyAttribute("CheckState") */
public class CheckBox extends ButtonBase

JScript

public class CheckBox extends ButtonBase

解説

CheckBox を使用すると、ユーザーに true/false、yes/no などのオプションを提示できます。CheckBox コントロールは、イメージ、テキスト、またはその両方を表示できます。

CheckBox コントロールと RadioButton コントロールには似た機能があり、ユーザーがオプションのリストから選択できるようにします。CheckBox コントロールは、複数のオプションを組み合わせて選択できるようにします。これに対して RadioButton コントロールは、複数のオプションから 1 つだけを選択できるようにします。

Appearance プロパティは、CheckBox を通常のCheckBox で表示するのか、またはボタンで表示するのかを決定します。

ThreeState プロパティは、コントロールで 2 ステートと 3 ステートのどちらをサポートするのかを決定します。Checked プロパティは、2 ステートのCheckBox コントロールの値を取得または設定するために使用し、CheckState プロパティは、3 ステートのCheckBox コントロールの値を取得または設定するために使用します。

メモ :
ThreeState プロパティが true に設定されている場合、Checked プロパティは、チェックされた状態と中間状態のどちらであるかを示す true を返します。

FlatStyle プロパティは、コントロールのスタイルと外観を決定します。FlatStyle プロパティが FlatStyle..::.System に設定されている場合は、ユーザーが使用しているオペレーティングシステムによってコントロールの外観が決定されます。

メモ :
FlatStyle プロパティが FlatStyle..::.System に設定されていると、CheckAlign プロパティの値は無視され、コントロールは ContentAlignment..::.MiddleLeft 値または ContentAlignment..::.MiddleRight 値を使用して整列および表示されます。CheckAlign プロパティの値が右揃えの 1 つに設定されている場合、コントロールは ContentAlignment..::.MiddleRight 値を使用して整列および表示されます。それ以外の場合は、ContentAlignment..::.MiddleLeft 値が使用されます。

メモ :

FlatStyle プロパティが FlatStyle..::.System に設定されていると、CheckAlign プロパティの値は無視され、コントロールは ContentAlignment..::.MiddleLeft 値または ContentAlignment..::.MiddleRight 値を使用して整列および表示されます。CheckAlign プロパティの値が右揃えの 1 つに設定されている場合、コントロールは ContentAlignment..::.MiddleRight 値を使用して整列および表示されます。それ以外の場合は、ContentAlignment..::.MiddleLeft 値が使用されます。

中間状態とは、次のような状態です。RichTextBox で選択したテキストを太字にするかどうかを決定する CheckBox があるとします。テキストを選択して CheckBox をクリックすると、選択したテキストが太字になります。同様に、テキストを選択すると、選択したテキストが太字かどうかが CheckBox に表示されます。選択したテキストに太字と標準の両方のテキストがある場合、CheckBox は中間状態となります。

例

CheckBox を作成および初期化し、その外観をトグルボタンにするコード例を次に示します。さらに、AutoCheck を false に設定し、トグルボタンを Form に追加します。

Visual Basic

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

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);
 }

Visual C++

public:
   void InstantiateMyCheckBox()
   {
      // Create and initialize a CheckBox.   
      CheckBox^ checkBox1 = gcnew 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 );
   }

public void InstantiateMyCheckBox()
{
    // Create and initialize a CheckBox.   
    CheckBox checkBox1 = new CheckBox();

    // Make the check box control appear as a toggle button.
    checkBox1.set_Appearance(Appearance.Button);

    // Turn off the update of the display on the click of the control.
    checkBox1.set_AutoCheck(false);

    // Add the check box control to the form.
    get_Controls().Add(checkBox1);
} //InstantiateMyCheckBox

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..::.Object
  System..::.MarshalByRefObject
    System.ComponentModel..::.Component
      System.Windows.Forms..::.Control
        System.Windows.Forms..::.ButtonBase
          System.Windows.Forms..::.CheckBox

スレッドセーフ

この型のすべてのパブリック static (Visual Basic では Shared) メンバは、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

バージョン情報