MainMenu Класс

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

MainMenu.cs

Внимание

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

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

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

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

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

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

Public Class MainMenu
Inherits Menu

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

Object

MarshalByRefObject

Component

Menu

MainMenu

Атрибуты

BrowsableAttribute ObsoleteAttribute

Примеры

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

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

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

Замечание

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

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

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

Поля

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

Свойства

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

Методы

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

События

Имя	Описание
Collapse	Устаревшие.. Происходит при сворачивании главного меню.

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

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