MenuItem.Checked Свойство

Определение

Возвращает или задает значение, указывающее, будет ли отображаться флажок рядом с текстом элемента меню.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

Значение свойства

Значение true, если рядом с элементом меню устанавливается флажок, и значение false в противном случае.true if there is a check mark next to the menu item; otherwise, false. Значение по умолчанию — false.The default is false.

Исключения

Элемент MenuItem является элементом верхнего меню или содержит дочерние элементы.The MenuItem is a top-level menu or has children.

Примеры

В следующем примере кода Checked свойство используется для предоставления состояния в приложении.The following code example uses the Checked property to provide the state in an application. В этом примере группа элементов меню используется для указания цвета текста в TextBox элементе управления.In this example, a group of menu items are used to specify the color for the text in a TextBox control. Предоставленный обработчик событий используется Click событием из трех пунктов меню.The event handler provided is used by the Click event of three menu items. Каждый пункт меню указывает цвет текста, menuItemRed (красный), menuItemGreen (зеленый) или menuItemBlue (синий).Each menu item specifies a text color, menuItemRed (Red), menuItemGreen (Green), or menuItemBlue (Blue). Обработчик событий определяет, какой пункт меню был нажат, помещает флажок в выбранный пункт меню и изменяет цвет текста TextBox элемента управления формы.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. В примере требуется, System.Drawing чтобы пространство имен было добавлено в форму, в которую помещен этот код.The example requires that the System.Drawing namespace has been added to the form that this code is placed in. В этом примере также требуется, TextBox чтобы в форму был добавлен объект, который находится в этом примере кода с именем. textBox1The 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

Комментарии

Можно использовать Checked свойство в сочетании с другими пунктами меню, чтобы указать состояние для приложения.You can use the Checked property in combination with other menu items in a menu to provide state for an application. Например, можно установить флажок для пункта меню в группе элементов, чтобы определить размер шрифта, отображаемого для текста в приложении.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. Также можно использовать Checked свойство для задания выбранного пункта меню в группе взаимоисключающих пунктов меню.You can also use the Checked property to identify the selected menu item in a group of mutually exclusive menu items.

Примечание

Этому свойству нельзя присвоить значение true для пунктов меню верхнего уровня.This property cannot be set to true for top-level menu items.

Применяется к