CheckBox クラス (System.Windows.Forms)

すべて縮小

言語フィルタ

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

Microsoft Visual Studio 2005/.NET Framework 2.0

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

.NET Framework クラスライブラリ

CheckBox クラス

Windows CheckBox を表します。

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

構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As CheckBox

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

C++

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class CheckBox : public ButtonBase

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

JScript

ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
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);
 }

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

スレッドセーフ

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

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報