MenuItem.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 er een vinkje wordt weergegeven naast de tekst van het menu-item.
public:
property bool Checked { bool get(); void set(bool value); };
public bool Checked { get; set; }
member this.Checked : bool with get, set
Public Property Checked As Boolean
Waarde van eigenschap
true als er een vinkje naast het menu-item staat; anders, false. De standaardwaarde is false.
Uitzonderingen
Het MenuItem is een menu op het hoogste niveau of heeft kinderen.
Voorbeelden
In het volgende codevoorbeeld wordt de Checked eigenschap gebruikt om de status in een toepassing op te geven. In dit voorbeeld wordt een groep menu-items gebruikt om de kleur voor de tekst in een TextBox besturingselement op te geven. De opgegeven gebeurtenis-handler wordt gebruikt door de Click gebeurtenis van drie menu-items. Elk menu-item geeft een tekstkleur op, menuItemRed (rood), menuItemGreen (groen) of menuItemBlue (blauw). De gebeurtenis-handler bepaalt op welk menu-item is geklikt, plaatst een vinkje in het geselecteerde menu-item en wijzigt de tekstkleur van het besturingselement van het formulier TextBox . Voor het voorbeeld moet de System.Drawing naamruimte zijn toegevoegd aan het formulier waarin deze code is geplaatst. Het voorbeeld vereist ook dat er een TextBox is toegevoegd aan het formulier waarin deze voorbeeldcode zich bevindt met de naam textBox1.
private:
// The following event handler would be connected to three menu items.
void MyMenuClick( Object^ sender, EventArgs^ e )
{
// Determine if clicked menu item is the Blue menu item.
if ( sender == menuItemBlue )
{
// Set the checkmark for the menuItemBlue menu item.
menuItemBlue->Checked = true;
// Uncheck the menuItemRed and menuItemGreen menu items.
menuItemRed->Checked = false;
menuItemGreen->Checked = false;
// Set the color of the text in the TextBox control to Blue.
textBox1->ForeColor = Color::Blue;
}
else if ( sender == menuItemRed )
{
// Set the checkmark for the menuItemRed menu item.
menuItemRed->Checked = true;
// Uncheck the menuItemBlue and menuItemGreen menu items.
menuItemBlue->Checked = false;
menuItemGreen->Checked = false;
// Set the color of the text in the TextBox control to Red.
textBox1->ForeColor = Color::Red;
}
else
{
// Set the checkmark for the menuItemGreen.
menuItemGreen->Checked = true;
// Uncheck the menuItemRed and menuItemBlue menu items.
menuItemBlue->Checked = false;
menuItemRed->Checked = false;
// Set the color of the text in the TextBox control to Blue.
textBox1->ForeColor = Color::Green;
}
}
// The following event handler would be connected to three menu items.
private void MyMenuClick(Object sender, EventArgs e)
{
// Determine if clicked menu item is the Blue menu item.
if(sender == menuItemBlue)
{
// Set the checkmark for the menuItemBlue menu item.
menuItemBlue.Checked = true;
// Uncheck the menuItemRed and menuItemGreen menu items.
menuItemRed.Checked = false;
menuItemGreen.Checked = false;
// Set the color of the text in the TextBox control to Blue.
textBox1.ForeColor = Color.Blue;
}
else if(sender == menuItemRed)
{
// Set the checkmark for the menuItemRed menu item.
menuItemRed.Checked = true;
// Uncheck the menuItemBlue and menuItemGreen menu items.
menuItemBlue.Checked = false;
menuItemGreen.Checked = false;
// Set the color of the text in the TextBox control to Red.
textBox1.ForeColor = Color.Red;
}
else
{
// Set the checkmark for the menuItemGreen.
menuItemGreen.Checked = true;
// Uncheck the menuItemRed and menuItemBlue menu items.
menuItemBlue.Checked = false;
menuItemRed.Checked = false;
// Set the color of the text in the TextBox control to Blue.
textBox1.ForeColor = Color.Green;
}
}
' The following event handler would be connected to three menu items.
Private Sub MyMenuClick(sender As Object, e As EventArgs)
' Determine if clicked menu item is the Blue menu item.
If sender Is menuItemBlue Then
' Set the checkmark for the menuItemBlue menu item.
menuItemBlue.Checked = True
' Uncheck the menuItemRed and menuItemGreen menu items.
menuItemRed.Checked = False
menuItemGreen.Checked = False
' Set the color of the text in the TextBox control to Blue.
textBox1.ForeColor = Color.Blue
Else
If sender Is menuItemRed Then
' Set the checkmark for the menuItemRed menu item.
menuItemRed.Checked = True
' Uncheck the menuItemBlue and menuItemGreen menu items.
menuItemBlue.Checked = False
menuItemGreen.Checked = False
' Set the color of the text in the TextBox control to Red.
textBox1.ForeColor = Color.Red
Else
' Set the checkmark for the menuItemGreen.
menuItemGreen.Checked = True
' Uncheck the menuItemRed and menuItemBlue menu items.
menuItemBlue.Checked = False
menuItemRed.Checked = False
' Set the color of the text in the TextBox control to Blue.
textBox1.ForeColor = Color.Green
End If
End If
End Sub
Opmerkingen
U kunt de Checked eigenschap in combinatie met andere menu-items in een menu gebruiken om de status voor een toepassing op te geven. U kunt bijvoorbeeld een vinkje plaatsen in een menu-item in een groep items om de grootte te bepalen van het lettertype dat moet worden weergegeven voor de tekst in een toepassing. U kunt de Checked eigenschap ook gebruiken om het geselecteerde menu-item in een groep met elkaar uitsluitende menu-items te identificeren.
Note
Deze eigenschap kan niet worden ingesteld true voor menu-items op het hoogste niveau.