Menu Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

Menu.cs

Внимание

Menu is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ToolStripDropDown and ToolStripDropDownMenu instead.

Представляет базовую функциональность для всех меню.

Этот класс недоступен в .NET Core 3.1 и более поздних версиях. Используйте ToolStripDropDown и ToolStripDropDownMenu вместо этого замените и расширьте Menu элемент управления.

public ref class Menu abstract : System::ComponentModel::Component

[System.ComponentModel.ListBindable(false)]
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public abstract class Menu : System.ComponentModel.Component

[<System.ComponentModel.ListBindable(false)>]
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type Menu = class
    inherit Component

Public MustInherit Class Menu
Inherits Component

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

Object

MarshalByRefObject

Component

Menu

Производный

System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Атрибуты

ListBindableAttribute BrowsableAttribute ObsoleteAttribute

Примеры

В следующем примере кода используется производный класс, MenuItemчтобы создать структуру меню для формы. Пример кода добавляет MenuItem элемент меню верхнего уровня, добавляет в него элемент подменю для выбора размера шрифта, а затем добавляет два подменю в этот пункт меню, представляющий большой и небольшой вариант шрифта в приложении. В примере требуется, чтобы был объект с именем и четырьмя объектами MainMenu с именем mainMenu1menuItem1, и menuItem4menuItem2menuItem3.MenuItem

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 и более поздних версиях. Взамен используйте ToolStripDropDown и ToolStripDropDownMenu.

Этот класс является базовым классом для MainMenuклассов и MenuItemContextMenu классов. Невозможно создать экземпляр этого класса. Меню для приложения состоят из MenuItem объектов. Они могут содержать другие MenuItem объекты, представляющие элементы подменю. Объекты MenuItem можно хранить в MainMenu виде всей структуры меню для формы или используемой ContextMenu для отображения контекстных меню. Этот класс предоставляет функциональные возможности, которые являются общими для всех классов меню.

В отличие от многих базовых классов, Menu класс использует производные классы для определения многих его свойств. Если вы используете меню в приложении многодокументного интерфейса (MDI), вы можете использовать MdiListItem это свойство, чтобы указать MenuItem список открытых дочерних форм MDI в приложении. Свойство MenuItems содержит список MenuItem объектов, хранящихся в классе меню. Для этого MainMenuContextMenuсвойства содержатся все MenuItem отображаемые объекты. MenuItem MenuItems Для свойства представляются элементы подменю, связанные с ним.

Помимо свойств, предоставляемых для всех производных классов меню, Menu класс также предоставляет методы, такие как CloneMenu и MergeMenu, что позволяет создавать новые меню из существующих меню, а также объединять две структуры меню вместе.

Класс Menu также определяет вложенный класс Menu.MenuItemCollection. Этот класс определяет коллекцию объектов, используемых MenuItem свойством MenuItems . Методы Menu.MenuItemCollection класса можно использовать для добавления и удаления элементов меню из MainMenuилиContextMenuMenuItem.

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

Имя	Описание
Menu(MenuItem[])	Устаревшие.. Инициализирует новый экземпляр класса Menu.

Поля

Имя	Описание
FindHandle	Устаревшие.. Указывает, что FindMenuItem(Int32, IntPtr) метод должен искать дескриптор.
FindShortcut	Устаревшие.. Указывает, что FindMenuItem(Int32, IntPtr) метод должен искать ярлык.

Свойства

Имя	Описание
Handle	Устаревшие.. Возвращает значение, представляющее дескриптор окна для меню.
IsParent	Устаревшие.. Возвращает значение, указывающее, содержит ли это меню любые элементы меню. Это свойство доступно только для чтения.
MdiListItem	Устаревшие.. Возвращает значение, указывающее MenuItem , что используется для отображения списка дочерних форм интерфейса документа (MDI).
MenuItems	Устаревшие.. Возвращает значение, указывающее коллекцию MenuItem объектов, связанных с меню.
Name	Устаревшие.. Возвращает или задает имя Menuобъекта .
Tag	Устаревшие.. Возвращает или задает определяемые пользователем данные, связанные с элементом управления.

Методы

Имя	Описание
CloneMenu(Menu)	Устаревшие.. Копирует данные Menu , передаваемые в качестве параметра в текущий Menu.
CreateMenuHandle()	Устаревшие.. Создает новый дескриптор Menuдля .
FindMenuItem(Int32, IntPtr)	Устаревшие.. Возвращает значение MenuItem , содержащее указанное значение.
FindMergePosition(Int32)	Устаревшие.. Возвращает позицию, в которую следует вставить элемент меню.
GetContextMenu()	Устаревшие.. Возвращает значение ContextMenu , содержащее это меню.
GetMainMenu()	Устаревшие.. Возвращает значение MainMenu , содержащее это меню.
MergeMenu(Menu)	Устаревшие.. MenuItem Объединяет объекты одного меню с текущим меню.
ProcessCmdKey(Message, Keys)	Устаревшие.. Обрабатывает ключ команды.

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

• MainMenu
• ContextMenu
• MenuItem