Auf Englisch lesen

Freigeben über


CheckBox.CheckState Eigenschaft

Definition

Ruft den CheckBox-Zustand ab oder legt ihn fest.

[System.ComponentModel.Bindable(true)]
public System.Windows.Forms.CheckState CheckState { get; set; }

Eigenschaftswert

Einer der CheckState-Enumerationswerte. Der Standardwert ist Unchecked.

Attribute

Ausnahmen

Der zugewiesene Wert ist keiner der CheckState-Enumerationswerte.

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 MiddleRightMiddleLeft und den CheckAlign -Werten von System.Drawing.ContentAlignmentund . 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 CheckBoxLabel - und Button alle in einem Formular instanziiert wurden und dass die Bezeichnung groß genug ist, um drei Textzeilen anzuzeigen, sowie einen Verweis auf den System.Drawing Namespace. Dieser Code sollte im Click Ereignishandler des -Steuerelements aufgerufen werden.

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(); 
 }

Hinweise

Wenn die ThreeState Eigenschaft auf falsefestgelegt ist, kann der CheckState Eigenschaftswert nur im Code und nicht durch Benutzerinteraktionen auf CheckState.Indeterminate festgelegt werden.

In der folgenden Tabelle wird der System.Windows.Forms.Appearance des CheckBox Steuerelements in seinen unterschiedlichen Zuständen für das Steuerelement und Button das Normal Stilsteuerelement beschriebenCheckBox.Appearance.

CheckState Appearance.Normal Appearance.Button
Checked Zeigt CheckBox ein Häkchen an. Das Steuerelement wird versenkt angezeigt.
Unchecked Die CheckBox ist leer. Das Steuerelement wird ausgelöst.
Indeterminate Zeigt CheckBox ein Häkchen an und ist schattiert. Das Steuerelement wird flach dargestellt.

Gilt für:

Produkt Versionen
.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

Weitere Informationen