CheckBox.CheckState 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得或設定 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

其中一個 CheckState 列舉值。 預設值是 Unchecked。

屬性

BindableAttribute

例外狀況

InvalidEnumArgumentException

所指派的值不是其中一個 CheckState 列舉值。

範例

下列程式碼範例會顯示標籤中三個屬性的值。 屬性 ThreeState 會在 和 false 之間 true 替代，並以 控制項的替代點選，以及 CheckAlign 的 MiddleRight 和 MiddleLeft 值 System.Drawing.ContentAlignment 之間的替代專案。 本範例示範屬性值在屬性變更時 ThreeState 如何變更，並檢查控制項。 此範例要求 CheckBox 在表單上具現化 和 LabelButton ，而且標籤夠大，足以顯示三行文字，以及命名空間的 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

備註

ThreeState如果屬性設定 false 為 ， CheckState 則屬性值只能在程式碼中設定為 CheckState.Indeterminate ，而不能由使用者互動設定。

下表描述 System.Windows.Forms.AppearanceCheckBox 控制項在 和 Button 樣式控制項的不同狀態中的 Normal 。 CheckBox.Appearance

CheckState	Appearance.Normal	Appearance.Button
Checked	會顯示 CheckBox 核取記號。	控制項會顯示下凹。
Unchecked	CheckBox 是空的。	控制項隨即引發。
Indeterminate	會顯示 CheckBox 核取記號並已著色。	控制項是平面的。

另請參閱

• Checked
• ThreeState