CheckBox.CheckState プロパティ

定義

CheckBox の状態を取得または設定します。

public:
 property System::Windows::Forms::CheckState CheckState { System::Windows::Forms::CheckState get(); void set(System::Windows::Forms::CheckState value); };
[System.ComponentModel.Bindable(true)]
public System.Windows.Forms.CheckState CheckState { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.CheckState : System.Windows.Forms.CheckState with get, set
Public Property CheckState As CheckState

プロパティ値

CheckState 列挙値のいずれか。 既定値は Unchecked です。

属性

例外

代入された値が、CheckState 列挙値ではありません。

次のコード例では、ラベル内の 3 つのプロパティの値を表示します。 プロパティはThreeState、 と false の間trueで交互にコントロールをクリックしCheckAlign、 と の値の間で交互にSystem.Drawing.ContentAlignmentMiddleRightMiddleLeft切り替えます。 この例では、プロパティが変更され、コントロールが ThreeState チェックされるときにプロパティ値がどのように変化するかを示します。 この例では、 CheckBoxLabelButton がすべてフォームでインスタンス化されていて、ラベルが 3 行のテキストと名前空間へのSystem.Drawing参照を表示するのに十分な大きさである必要があります。 このコードは、 コントロールの Click イベント ハンドラーで呼び出す必要があります。

private:
   void AdjustMyCheckBoxProperties()
   {
      // Concatenate the property values together on three lines.
      label1->Text = String::Format( "ThreeState: {0}\nChecked: {1}\nCheckState: {2}",
         checkBox1->ThreeState, checkBox1->Checked, checkBox1->CheckState );
      
      // Change the ThreeState and CheckAlign properties on every other click.
      if ( !checkBox1->ThreeState )
      {
         checkBox1->ThreeState = true;
         checkBox1->CheckAlign = ContentAlignment::MiddleRight;
      }
      else
      {
         checkBox1->ThreeState = false;
         checkBox1->CheckAlign = ContentAlignment::MiddleLeft;
      }
   }
private void AdjustMyCheckBoxProperties()
 {
    // Change the ThreeState and CheckAlign properties on every other click.
    if (!checkBox1.ThreeState)
    {
       checkBox1.ThreeState = true;
       checkBox1.CheckAlign = ContentAlignment.MiddleRight;
    }
    else
    {
       checkBox1.ThreeState = false;
       checkBox1.CheckAlign = ContentAlignment.MiddleLeft;
    }

    // Concatenate the property values together on three lines.
    label1.Text = "ThreeState: " + checkBox1.ThreeState.ToString() + "\n" +
                  "Checked: " + checkBox1.Checked.ToString() + "\n" +
                  "CheckState: " + checkBox1.CheckState.ToString(); 
 }
Private Sub AdjustMyCheckBoxProperties()

    ' Change the ThreeState and CheckAlign properties on every other click.
    If Not checkBox1.ThreeState Then
        checkBox1.ThreeState = True
        checkBox1.CheckAlign = ContentAlignment.MiddleRight
    Else
        checkBox1.ThreeState = False
        checkBox1.CheckAlign = ContentAlignment.MiddleLeft
    End If

    ' Concatenate the property values together on three lines.
    label1.Text = "ThreeState: " & checkBox1.ThreeState.ToString() & ControlChars.Cr & _
        "Checked: " & checkBox1.Checked.ToString() & ControlChars.Cr & _
        "CheckState: " & checkBox1.CheckState.ToString()

End Sub

注釈

プロパティが ThreeStatefalse設定されている場合、プロパティ値 CheckState はコード内でのみ に CheckState.Indeterminate 設定でき、ユーザーの操作では設定できません。

次の表では、 System.Windows.Forms.Appearance および Button スタイル コントロールのさまざまなCheckBox状態の コントロールの についてNormal説明しますCheckBox.Appearance

CheckState Appearance.Normal Appearance.Button
Checked にはCheckBox、チェックマークが表示されます。 コントロールがくぼんだように見えます。
Unchecked CheckBox が空です。 コントロールが上に表示されます。
Indeterminate にはCheckBox、チェックマークが表示され、網掛けされます。 コントロールがフラットに表示されます。

適用対象

こちらもご覧ください