MenuItem.Checked Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob neben dem Text des Menüelements ein Häkchen angezeigt wird, oder legt diesen fest.Gets or sets a value indicating whether a check mark appears next to the text of the 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

Eigenschaftswert

true, wenn das Menüelement mit einem Häkchen versehen ist, andernfalls false.true if there is a check mark next to the menu item; otherwise, false. Der Standardwert ist false.The default is false.

Ausnahmen

Das MenuItem ist ein Menü der obersten Ebene oder verfügt über untergeordnete Elemente.The MenuItem is a top-level menu or has children.

Beispiele

Im folgenden Codebeispiel wird die Checked-Eigenschaft verwendet, um den Status in einer Anwendung bereitzustellen.The following code example uses the Checked property to provide the state in an application. In diesem Beispiel wird eine Gruppe von Menü Elementen verwendet, um die Farbe für den Text in einem TextBox Steuerelement anzugeben.In this example, a group of menu items are used to specify the color for the text in a TextBox control. Der angegebene Ereignishandler wird vom Click-Ereignis von drei Menü Elementen verwendet.The event handler provided is used by the Click event of three menu items. Jedes Menü Element gibt eine Textfarbe an, menuItemRed (rot), menuItemGreen (grün) oder menuItemBlue (blau).Each menu item specifies a text color, menuItemRed (Red), menuItemGreen (Green), or menuItemBlue (Blue). Der Ereignishandler bestimmt, auf welches Menü Element geklickt wurde, platziert ein Häkchensymbol für das ausgewählte Menü Element und ändert die Textfarbe des TextBox Steuer Elements des Formulars.The event handler determines which menu item was clicked, places a checkmark to the selected menu item, and changes the text color of the form's TextBox control. Das Beispiel setzt voraus, dass der System.Drawing-Namespace dem Formular hinzugefügt wurde, in dem dieser Code platziert wird.The example requires that the System.Drawing namespace has been added to the form that this code is placed in. Das Beispiel erfordert auch, dass ein TextBox dem Formular hinzugefügt wurde, in dem sich dieser Beispielcode befindet, der als textBox1bezeichnet wird.The example also requires that a TextBox has been added to the form that this example code is located in that is named 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

Hinweise

Sie können die Checked-Eigenschaft in Kombination mit anderen Menü Elementen in einem Menü verwenden, um den Zustand für eine Anwendung bereitzustellen.You can use the Checked property in combination with other menu items in a menu to provide state for an application. Beispielsweise können Sie ein Häkchen für ein Menü Element in einer Gruppe von Elementen platzieren, um die Größe der Schriftart zu identifizieren, die für den Text in einer Anwendung angezeigt werden soll.For example, you can place a check mark on a menu item in a group of items to identify the size of the font to be displayed for the text in an application. Sie können auch die Checked-Eigenschaft verwenden, um das ausgewählte Menü Element in einer Gruppe von sich gegenseitig ausschließenden Menü Elementen zu identifizieren.You can also use the Checked property to identify the selected menu item in a group of mutually exclusive menu items.

Hinweis

Diese Eigenschaft kann für Menü Elemente der obersten Ebene nicht auf true festgelegt werden.This property cannot be set to true for top-level menu items.

Gilt für: