CheckBox.Checked Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob sich die CheckBox im aktivierten Zustand befindet, oder legt diesen fest.
public:
property bool Checked { bool get(); void set(bool value); };
[System.ComponentModel.Bindable(true)]
public bool Checked { get; set; }
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.SettingsBindable(true)]
public bool Checked { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Checked : bool with get, set
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.SettingsBindable(true)>]
member this.Checked : bool with get, set
Public Property Checked As Boolean
Eigenschaftswert
true
, wenn sich die CheckBox im aktivierten Zustand befindet, andernfalls false
. Der Standardwert ist false
.
Hinweis: Wenn die ThreeState -Eigenschaft auf true
festgelegt ist, gibt die Checked -Eigenschaft entweder für ein Checked
oder Indeterminate
CheckStatezurücktrue
.
- Attribute
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.
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, zeigt true
der CheckBox Teil des Steuerelements ein Häkchen an. Wenn die Appearance -Eigenschaft auf Button
festgelegt ist, wird das Steuerelement bei der Einstellung gesunken true
Checked angezeigt und wie eine Standardschaltfläche ausgelöst, wenn false
.