CheckBox.Checked Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

CheckBox.cs

öğesinin işaretli durumda olup olmadığını CheckBox belirten bir değer alır veya ayarlar.

public:
 property bool Checked { bool get(); void set(bool value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.SettingsBindable(true)]
public bool Checked { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.SettingsBindable(true)>]
member this.Checked : bool with get, set

Public Property Checked As Boolean

Özellik Değeri

Boolean

true CheckBox işaretli durumdaysa; değilse, false. Varsayılan değer false değeridir.

Not: Özellik olarak ayarlanırsa ThreeStateCheckedtrue, özellik veya IndeterminateCheckStateChecked için döndürülecektir.true

Öznitelikler

BindableAttribute SettingsBindableAttribute

Örnekler

Aşağıdaki kod örneği, bir etiketteki üç özelliğin değerlerini görüntüler. özelliği, denetimin CheckAlign değişen tıklamalarıyla ve arasında, falsetrue değeri MiddleLeftile arasında ContentAlignmentMiddleRight da değişir.ThreeState 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

değeri olduğunda true, denetimin CheckBox bir bölümü bir onay işareti görüntüler. Appearance özelliği olarak ayarlanırsaButton, denetim olduğunda Checkedtrue batık görünür ve olduğunda falsestandart bir düğme gibi yükseltilir.

Ayrıca bkz.

• ThreeState
• CheckState