CheckBox.CheckState Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

CheckBox.cs

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. Varsayılan değer Unchecked değeridir.

Ö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 truefalse, ThreeState denetimin CheckAlign değişen tıklamalarıyla ve ile değerleri arasında MiddleLeftMiddleRight geçiş yaparak 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 CheckBoxLabelButton ve öğesinin bir formda örneği oluşturulması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 System.Windows.Forms.AppearanceCheckBox ve Button stil denetimi için farklı durumlarındaki durumu CheckBox.AppearanceNormal açıklanmaktadır.

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ölgelendirilir.	Denetim düz görünür.

Ayrıca bkz.

• Checked
• ThreeState