MenuItem Класс

Определение

public ref class MenuItem : System::Windows::Forms::Menu

public class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Наследование

Object

MarshalByRefObject

Component

Menu

MenuItem

Примеры

В следующем примере кода создается структура меню для формы. В примере кода добавляется MenuItem для представления пункта меню верхнего уровня, добавляется в него элемент подменю для выбора размера шрифта, а затем к этому элементу меню добавляются два элемента подменю, которые представляют большие и малые варианты шрифтов в приложении. В этом примере требуется объект с MainMenu именем mainMenu1 и четыре MenuItem объекта с именами menuItem1, menuItem2, menuItem3и menuItem4.

public:
   void CreateMyMenu()
   {
      // Set the caption for the top-level menu item.
      menuItem1->Text = "Edit";
      // Set the caption for the first submenu.
      menuItem2->Text = "Font Size";
      // Set the caption for menuItem2's first submenu.
      menuItem3->Text = "Small";
      // Set the checked property to true since this is the default value.
      menuItem3->Checked = true;
      // Define a shortcut key combination for the menu item.
      menuItem3->Shortcut = Shortcut::CtrlS;
      // Set the caption of the second sub menu item of menuItem2.
      menuItem4->Text = "Large";
      // Define a shortcut key combination for the menu item.
      menuItem4->Shortcut = Shortcut::CtrlL;
      // Set the index of the menu item so it is placed below the first submenu item.
      menuItem4->Index = 1;
      // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
      menuItem2->MenuItems->Add( menuItem3 );
      menuItem2->MenuItems->Add( menuItem4 );
      // Add menuItem2 to menuItem1's list of menu items.
      menuItem1->MenuItems->Add( menuItem2 );
      // Add menuItem1 to the MainMenu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
   }

public void CreateMyMenu()
    {
    // Set the caption for the top-level menu item.
    menuItem1.Text = "Edit";
    // Set the caption for the first submenu.
    menuItem2.Text = "Font Size";
    // Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small";
    // Set the checked property to true since this is the default value.
    menuItem3.Checked = true;
    // Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS;
    // Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large";
    // Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL;
    // Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1;
    // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3);
    menuItem2.MenuItems.Add(menuItem4);
    // Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2);
    // Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1);
    }

Public Sub CreateMyMenu()
    ' Set the caption for the top-level menu item.
    menuItem1.Text = "Edit"
    ' Set the caption for the first submenu.
    menuItem2.Text = "Font Size"
    ' Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small"
    ' Set the checked property to true since this is the default value.
    menuItem3.Checked = True
    ' Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS
    ' Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large"
    ' Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL
    ' Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1
    ' Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3)
    menuItem2.MenuItems.Add(menuItem4)
    ' Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2)
    ' Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
End Sub

Комментарии

Этот класс недоступен в .NET Core 3.1 и более поздних версиях. Взамен рекомендуется использовать ToolStripMenuItem.

Для MenuItem отображения необходимо добавить его в MainMenu или ContextMenu. Чтобы создать подменю, можно добавить MenuItem объекты в MenuItems свойство родительского MenuItemобъекта .

Класс MenuItem предоставляет свойства, позволяющие настроить внешний вид и функциональность элемента меню. Чтобы отобразить проверка метку рядом с пунктом меню, используйте Checked свойство . Эту функцию можно использовать для идентификации пункта меню, выбранного в списке взаимоисключающих пунктов меню. Например, если у вас есть набор пунктов меню для настройки цвета текста в элементе TextBox управления, можно использовать Checked свойство , чтобы определить, какой цвет выбран в данный момент. Свойство Shortcut можно использовать для определения сочетания клавиатуры, которую можно нажимать для выбора пункта меню.

Для MenuItem объектов, отображаемых в приложении многодокументного интерфейса (MDI), можно использовать MergeMenu метод , чтобы объединить меню родительского элемента MDI с меню его дочерних форм, чтобы создать консолидированную структуру меню. MenuItem Так как нельзя повторно использовать в нескольких расположениях одновременно, например в MainMenu и ContextMenu, можно использовать CloneMenu метод для создания копии для использования в другом расположенииMenuItem.

Событие Popup позволяет выполнять задачи перед отображением меню. Например, можно создать обработчик событий для этого события, чтобы отображать или скрывать пункты меню в зависимости от состояния кода. Событие Select позволяет выполнять такие задачи, как предоставление подробной справки по пунктам меню приложения, когда пользователь навести указатель мыши на элемент меню.

Конструкторы

Поля

Свойства

Методы

События

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

См. также раздел

• MainMenu
• Menu
• MenuMerge
• ContextMenu