CheckBox.CheckState Özellik

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Kaynak:: CheckBox.cs

Kaynak:: CheckBox.cs

Kaynak:: CheckBox.cs

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

durumunu CheckBoxalır veya ayarlar.

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

Özellik Değeri

CheckState

Numaralandırma değerlerinden CheckState biri. Unchecked varsayılan değerdir.

Öznitelikler: BindableAttribute

Özel durumlar

InvalidEnumArgumentException

Atanan değer numaralandırma değerlerinden CheckState biri değil.

Örnekler

Aşağıdaki kod örneği, bir etiketteki üç özelliğin değerlerini görüntüler. özelliği, ThreeState denetimin CheckAlign alternatif tıklamalarıyla ve arasında, falsetrue ve MiddleLeft değerleri arasında MiddleRight da alternatif olarak System.Drawing.ContentAlignmentdeğişir. Bu örnekte, özellik değiştikçe ve denetim denetlendikçe ThreeState özellik değerlerinin nasıl değiştiği gösterilir. Bu örnek, bir CheckBox Label Button ve tüm örneğinin bir formda örneğini oluşturmasını ve etiketin üç metin satırı ve ad alanına başvuru System.Drawing görüntüleyecek kadar büyük olmasını gerektirir. Bu kod denetimin Click olay işleyicisinde çağrılmalıdır.

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

Açıklamalar

ThreeState Özelliği olarak falseCheckState ayarlanırsa, özellik değeri kullanıcı etkileşimi tarafından değil yalnızca kodda olarak ayarlanabilirCheckState.Indeterminate.

Aşağıdaki tabloda, denetimin ve stil denetimi için farklı durumlarındaki durumu CheckBox.AppearanceNormal açıklanmaktadırSystem.Windows.Forms.Appearance.ButtonCheckBox

Checkstate	Görünüm.Normal	Görünüm.Düğme
`Checked`	onay CheckBox işareti görüntüler.	Denetim batık görünür.
`Unchecked`	CheckBox boş.	Denetim yükseltilmiş olarak görünür.
`Indeterminate`	onay CheckBox işareti görüntüler ve gölgelidir.	Denetim düz görünür.

Şunlara uygulanır

Ürün	Sürümler
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Aracılığıyla paylaş