CheckBox.Checked Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de CheckBox status Gecontroleerd is.
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
Waarde van eigenschap
trueals de CheckBox status Gecontroleerd is, anders. false De standaardwaarde is false.
Opmerking: Als de ThreeState eigenschap is ingesteld op true, wordt de Checked eigenschap geretourneerd true voor een Checked of IndeterminateCheckState.
- Kenmerken
Voorbeelden
In het volgende codevoorbeeld worden de waarden van drie eigenschappen in een label weergegeven. De ThreeState eigenschap wisselt tussen true en false met afwisselende klikken van het besturingselement en de CheckAlign alternatieven tussen een ContentAlignment waarde van MiddleRight en MiddleLeft. In dit voorbeeld ziet u hoe de eigenschapswaarden veranderen wanneer de ThreeState eigenschap verandert en het besturingselement wordt gecontroleerd. In dit voorbeeld is vereist dat een CheckBox, Label en Button allemaal zijn geïnstantieerd op een formulier en dat het label groot genoeg is om drie regels tekst weer te geven, evenals een verwijzing naar de System.Drawing naamruimte. Deze code moet worden aangeroepen in de Click gebeurtenis-handler van het besturingselement.
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
Opmerkingen
Wanneer de waarde is true, wordt in het CheckBox gedeelte van het besturingselement een vinkje weergegeven. Als de Appearance eigenschap is ingesteld Buttonop, wordt het besturingselement als een standaardknop weergegeven wanneer Checked deze wordt true weergegeven en verhoogd als een standaardknop false.