CheckBox.CheckState プロパティ

定義

CheckBox の状態を取得または設定します。Gets or sets the state of the 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; }
member this.CheckState : System.Windows.Forms.CheckState with get, set
Public Property CheckState As CheckState

プロパティ値

CheckState 列挙値のいずれか。One of the CheckState enumeration values. 既定値は Unchecked です。The default value is Unchecked.

属性

例外

代入された値が、CheckState 列挙値ではありません。The value assigned is not one of the CheckState enumeration values.

次のコード例では、ラベルの3つのプロパティの値を表示します。The following code example displays the values of three properties in a label. プロパティThreeStateは、とtrue MiddleRight MiddleLeft System.Drawing.ContentAlignmentの間で、コントロールCheckAlignを交互にクリックし、との値との値を交互に交互に切り替えます。 falseThe ThreeState property alternates between true and false with alternating clicks of the control and the CheckAlign alternates between the MiddleRight and MiddleLeft values of System.Drawing.ContentAlignment. この例では、プロパティがThreeState変更され、コントロールがチェックされると、プロパティ値がどのように変化するかを示します。This example shows how the property values change as the ThreeState property changes and the control is checked. このCheckBox例では、、 Label 、およびButtonがすべてフォーム上でインスタンス化されていること、およびラベルが3行のテキストSystem.Drawingを表示するのに十分な大きさであること、および名前空間への参照が必要であることが必要です。This example requires that a CheckBox, Label and Button have all been instantiated on a form and that the label is large enough to display three lines of text, as well as a reference to the System.Drawing namespace. このコードは、コントロールのClickイベントハンドラーで呼び出す必要があります。This code should be called in the Click event handler of the control.

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

注釈

プロパティがにfalse設定されているCheckState場合、プロパティ値は、ユーザー CheckState.Indeterminateの操作ではなく、コード内でのみに設定できます。 ThreeStateIf the ThreeState property is set to false, the CheckState property value can only be set to CheckState.Indeterminate in code and not by user interaction.

次の表ではSystem.Windows.Forms.AppearanceCheckBoxコントロールのNormalButtonスタイルコントロールCheckBox.Appearanceのさまざまな状態について説明します。The following table describes the System.Windows.Forms.Appearance of the CheckBox control in its different states for the Normal and Button style control CheckBox.Appearance.

CheckStateCheckState 外観。標準Appearance.Normal [外観] ボタンAppearance.Button
Checked CheckBoxチェックマークが表示されます。The CheckBox displays a check mark. コントロールがくぼんで表示されます。The control appears sunken.
Unchecked CheckBox が空です。The CheckBox is empty. コントロールが発生します。The control appears raised.
Indeterminate CheckBoxチェックマークが表示され、網掛けされます。The CheckBox displays a check mark and is shaded. コントロールがフラットに表示されます。The control appears flat.

適用対象

こちらもご覧ください