MainMenu Класс

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Предоставляет структуру меню формы.

Этот класс недоступен в .NET Core 3.1 и более поздних версиях. Вместо него следует использовать класс MenuStrip, который заменяет и расширяет элемент управления MainMenu.

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

public class MainMenu : System.Windows.Forms.Menu

type MainMenu = class
    inherit Menu

Public Class MainMenu
Inherits Menu

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

Object

MarshalByRefObject

Component

Menu

MainMenu

Примеры

В следующем примере кода создается MainMenu, присваивается два MenuItem объекта MainMenu и выполняется привязка к форме. В этом примере требуется создать объект с Form именем Form1.

void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu^ mainMenu1 = gcnew MainMenu;
   MenuItem^ menuItem1 = gcnew MenuItem;
   MenuItem^ menuItem2 = gcnew MenuItem;
   menuItem1->Text = "File";
   menuItem2->Text = "Edit";

   // Add two MenuItem objects to the MainMenu.
   mainMenu1->MenuItems->Add( menuItem1 );
   mainMenu1->MenuItems->Add( menuItem2 );

   // Bind the MainMenu to Form1.
   Menu = mainMenu1;
}

public void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu mainMenu1 = new MainMenu();

   MenuItem menuItem1 = new MenuItem();
   MenuItem menuItem2 = new MenuItem();

   menuItem1.Text = "File";
   menuItem2.Text = "Edit";
   // Add two MenuItem objects to the MainMenu.
   mainMenu1.MenuItems.Add(menuItem1);
   mainMenu1.MenuItems.Add(menuItem2);
   
   // Bind the MainMenu to Form1.
   Menu = mainMenu1;   
}

Public Sub CreateMyMainMenu()
    ' Create an empty MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()
       
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"
    ' Add two MenuItem objects to the MainMenu.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu1.MenuItems.Add(menuItem2)
       
    ' Bind the MainMenu to Form1.
    Menu = mainMenu1
End Sub

Комментарии

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

Элемент MainMenu управления представляет контейнер для структуры меню формы. Меню состоит из MenuItem объектов, представляющих отдельные команды меню в структуре меню. Каждый из них MenuItem может быть командой для приложения или родительским меню для других элементов подменю. Чтобы привязать MainMenu к объекту Form , который будет отображать его, назначьте MainMenu свойству FormMenu объекта .

Для приложений, поддерживающих несколько языков, можно использовать RightToLeft свойство для отображения текста меню справа налево для поддержки таких языков, как арабский.

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

Примечание

Вырезание и вставка элементов меню из одной формы в другую в конструкторе может не работать должным образом, если для формы, вставляемой в нее не определены пункты меню.

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

MainMenu()	Инициализирует новый экземпляр класса MainMenu без каких-либо заданных элементов меню.
MainMenu(IContainer)	Инициализирует новый экземпляр класса MainMenu с указанным контейнером.
MainMenu(MenuItem[])	Инициализирует новый экземпляр класса MainMenu с указанным набором объектов MenuItem.

Поля

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

Свойства

CanRaiseEvents	Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component)
Container	Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от Component)
DesignMode	Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component)
Events	Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component)
Handle	Получает значение, представляющее дескриптор окна для меню. (Унаследовано от Menu)
IsParent	Получает значение, показывающее, содержит ли это меню какие-нибудь элементы меню. Это свойство доступно только для чтения. (Унаследовано от Menu)
MdiListItem	Получает значение, указывающее объект MenuItem, используемый для отображения списка дочерних форм многодокументного интерфейса (MDI). (Унаследовано от Menu)
MenuItems	Получает значение, показывающее коллекцию объектов MenuItem, связанных с данным меню. (Унаследовано от Menu)
Name	Возвращает или задает имя таблицы для объекта Menu. (Унаследовано от Menu)
RightToLeft	Возвращает или устанавливает значение, указывающее, должен ли текст, выводимый на экран элементом управления, отображаться справа налево.
Site	Получает или задает ISite объекта Component. (Унаследовано от Component)
Tag	Получает или задает определяемые пользователем данные, связанные с элементом управления. (Унаследовано от Menu)

Методы

CloneMenu()	Создает новый объект MainMenu, который является дубликатом текущего объекта MainMenu.
CloneMenu(Menu)	Копирует объект Menu, передаваемый в качестве параметра в текущий объект Menu. (Унаследовано от Menu)
CreateMenuHandle()	Создает новый дескриптор для меню.
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Освобождает все ресурсы, занятые модулем Component. (Унаследовано от Component)
Dispose(Boolean)	Уничтожает ресурсы (кроме памяти), используемые классом MainMenu.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindMenuItem(Int32, IntPtr)	Получает объект MenuItem, содержащий указываемое значение. (Унаследовано от Menu)
FindMergePosition(Int32)	Возвращает позицию меню, в которую должен быть вставлен элемент меню. (Унаследовано от Menu)
GetContextMenu()	Получает объект ContextMenu, содержащий это меню. (Унаследовано от Menu)
GetForm()	Получает объект Form, содержащий этот элемент управления.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetMainMenu()	Получает объект MainMenu, содержащий это меню. (Унаследовано от Menu)
GetService(Type)	Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
MergeMenu(Menu)	Объединяет объекты MenuItem одного меню с текущим меню. (Унаследовано от Menu)
OnCollapse(EventArgs)	Вызывает событие Collapse.
ProcessCmdKey(Message, Keys)	Обрабатывает клавишу для команд. (Унаследовано от Menu)
ToString()	Возвращает строку, представляющую объект MainMenu.

События

Collapse	Происходит при сворачивании главного меню.
Disposed	Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component)

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

• MenuItem
• Add(String)
• Menu
• MenuItems
• MenuStrip
• ContextMenuStrip
• Элемент управления MenuStrip (Windows Forms)