CheckBox.Checked Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

CheckBox.cs

Ruft einen Wert ab, der angibt, ob sich die CheckBox im aktivierten Zustand befindet, oder legt diesen fest.

C#

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

Eigenschaftswert

Boolean

true, wenn sich die CheckBox im aktivierten Zustand befindet, andernfalls false. Der Standardwert ist false.

Hinweis: Wenn die ThreeState -Eigenschaft auf truefestgelegt ist, gibt die Checked -Eigenschaft entweder für ein Checked oder IndeterminateCheckStatezurücktrue.

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 wechselnden Klicks des -Steuerelements und der CheckAlign Alternative zwischen einem ContentAlignment Wert von MiddleRight und MiddleLeft. Dieses Beispiel zeigt, 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 sowie einen Verweis auf den System.Drawing Namespace anzuzeigen. Dieser Code sollte im Click Ereignishandler des -Steuerelements aufgerufen werden.

C#

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 der Wert ist, zeigt trueder CheckBox Teil des Steuerelements ein Häkchen an. Wenn die Appearance -Eigenschaft auf Buttonfestgelegt ist, wird das Steuerelement bei der Einstellung gesunken trueChecked angezeigt und wie eine Standardschaltfläche ausgelöst, wenn false.

Gilt für:

Weitere Informationen

• ThreeState
• CheckState