CheckBox.Checked Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger ett värde som anger om CheckBox är i markerat tillstånd.
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
Egenskapsvärde
true
CheckBox om är i det kontrollerade tillståndet, annars . false Standardvärdet är false.
Obs! Om egenskapen ThreeState är inställd på trueCheckedreturneras true egenskapen för antingen en Checked eller IndeterminateCheckState.
- Attribut
Exempel
I följande kodexempel visas värdena för tre egenskaper i en etikett. Egenskapen ThreeState växlar mellan true och false med alternerande klick i kontrollen och CheckAlign växlar mellan värdet ContentAlignmentMiddleRight och MiddleLeft. Det här exemplet visar hur egenskapsvärdena ändras när ThreeState egenskapen ändras och kontrollen kontrolleras. Det här exemplet kräver att en CheckBox, Label och Button alla har instansierats i ett formulär och att etiketten är tillräckligt stor för att visa tre textrader samt en referens till System.Drawing namnområdet. Den här koden ska anropas i Click händelsehanteraren för kontrollen.
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
Kommentarer
När värdet är trueCheckBox visar kontrollens del en bockmarkering. Om egenskapen Appearance är inställd Buttonpå visas kontrollen nedsänkt när Checked den är true och aktiveras som en standardknapp när false.