CheckBox.Checked Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

CheckBox.cs

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob sich der CheckBox eingecheckte Zustand befindet.

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

Eigenschaftswert

Boolean

true wenn sich der CheckBox Status "eingecheckt" befindet, andernfalls false. Der Standardwert ist false.

Hinweis: Wenn die ThreeState Eigenschaft auf true festgelegt ist, wird true die Checked Eigenschaft entweder für ein Checked oder IndeterminateCheckState.

Attribute

BindableAttribute SettingsBindableAttribute

Beispiele

Im folgenden Codebeispiel werden die Werte von drei Eigenschaften in einer Bezeichnung angezeigt. Die ThreeState Eigenschaft wechselt zwischen true und false mit abwechselnden Klicks des Steuerelements und den CheckAlign Alternativen zwischen einem ContentAlignment Wert von MiddleRight und MiddleLeft. In diesem Beispiel wird gezeigt, wie sich die Eigenschaftswerte ändern, wenn sich die ThreeState Eigenschaft ändert und das Steuerelement überprüft wird. Dieses Beispiel erfordert, dass ein CheckBox, Label und Button alle auf einem Formular instanziiert wurden und dass die Beschriftung groß genug ist, um drei Textzeilen sowie einen Verweis auf den System.Drawing Namespace anzuzeigen. Dieser Code sollte im Click Ereignishandler des Steuerelements aufgerufen werden.

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

Hinweise

Wenn der Wert ist true, zeigt der CheckBox Teil des Steuerelements ein Häkchen an. Wenn die Appearance Eigenschaft auf Button festgelegt ist, wird das Steuerelement eingetaucht, wenn Checked es wie eine Standardschaltfläche falseausgelöst wirdtrue.

Weitere Informationen

• ThreeState
• CheckState