CheckBox.Checked Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob sich die CheckBox im aktivierten Zustand befindet, oder legt diesen fest.Gets or set a value indicating whether the CheckBox is in the checked state.

public:
 property bool Checked { bool get(); void set(bool value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.SettingsBindable(true)]
public bool Checked { get; set; }
member this.Checked : bool with get, set
Public Property Checked As Boolean

Eigenschaftswert

true, wenn sich die CheckBox im aktivierten Zustand befindet, andernfalls false.true if the CheckBox is in the checked state; otherwise, false. Der Standardwert ist false.The default value is false.


Wenn die ThreeState-Eigenschaft auf true festgelegt ist, gibt die Checked-Eigenschaft true für einen Checked mit dem Wert Indeterminate oder mit dem Wert CheckState zurück.If the ThreeState property is set to true, the Checked property will return true for either a Checked or IndeterminateCheckState.

Attribute

Beispiele

Im folgenden Codebeispiel werden die Werte von drei Eigenschaften in einer Bezeichnung angezeigt.The following code example displays the values of three properties in a label. Die ThreeState-Eigenschaft wechselt zwischen true und false mit wechselnden Klicks des-Steuer Elements, und der CheckAlign wechselt zwischen einem ContentAlignment Wert von MiddleRight und MiddleLeft.The ThreeState property alternates between true and false with alternating clicks of the control and the CheckAlign alternates between a ContentAlignment value of MiddleRight and MiddleLeft. Dieses Beispiel zeigt, wie sich die Eigenschaftswerte ändern, wenn sich die ThreeState-Eigenschaft ändert und das-Steuerelement aktiviert ist.This example shows how the property values change as the ThreeState property changes and the control is checked. Für dieses Beispiel ist es erforderlich, dass eine CheckBox, Label und Button auf einem Formular instanziiert wurden und dass die Bezeichnung groß genug ist, um drei Textzeilen anzuzeigen, sowie einen Verweis auf den System.Drawing Namespace.This example requires that a CheckBox, Label and Button have all been instantiated on a form and that the label is large enough to display three lines of text, as well as a reference to the System.Drawing namespace. Dieser Code sollte im Click-Ereignishandler des-Steuer Elements aufgerufen werden.This code should be called in the Click event handler of the control.

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 trueist, wird im CheckBox Teil des-Steuer Elements ein Häkchen angezeigt.When the value is true, the CheckBox portion of the control displays a check mark. Wenn die Appearance-Eigenschaft auf Buttonfestgelegt ist, wird das Steuerelement abgesenkten, wenn Checked true ist und beim falsewie eine Standard Schaltfläche ausgelöst wird.If the Appearance property is set to Button, the control will appear sunken when Checked is true and raised like a standard button when false.

Gilt für:

Siehe auch