MainMenu Класс

Определение

Предоставляет структуру меню формы.Represents the menu structure of a form. Хотя элемент управления MenuStrip заменяет элемент управления MainMenu предыдущих версий и расширяет его функциональные возможности, однако при необходимости элемент управления MainMenu можно сохранить для обратной совместимости и использования в будущем.Although MenuStrip replaces and adds functionality to the MainMenu control of previous versions, MainMenu is retained for both backward compatibility and future use if you choose.

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
Наследование

Примеры

В следующем примере кода создается объект MainMenu, который присваивается MenuItem двум объектам MainMenu и привязывается к форме.The following code example creates a MainMenu, assigns two MenuItem objects to the MainMenu and binds it to a form. В этом примере необходимо создать объект Form с именем. Form1This example requires that you have a Form created that is named 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

Комментарии

MainMenu Элемент управления представляет контейнер для структуры меню формы.The MainMenu control represents the container for the menu structure of a form. Меню состоит из MenuItem объектов, представляющих отдельные команды меню в структуре меню.A menu is composed of MenuItem objects that represent the individual menu commands in the menu structure. Каждый MenuItem может быть командой для приложения или родительским меню для других пунктов подменю.Each MenuItem can be a command for your application or a parent menu for other submenu items. Чтобы привязать MainMenu к элементу Form , который будет MainMenu отображать его Menu , присвойте свойству значение Formсвойства.To bind the MainMenu to the Form that will display it, assign the MainMenu to the Menu property of the Form.

Для приложений, которые будут поддерживать несколько языков, можно использовать RightToLeft свойство для вывода текста меню справа налево для поддержки таких языков, как арабский.For applications that will have support for multiple languages, you can use the RightToLeft property to display the text of the menu from right to left to support languages such as Arabic.

Можно создать различные MainMenu объекты для представления различных структур меню для формы.You can create different MainMenu objects to represent different menu structures for your form. Если вы хотите повторно использовать структуру меню, содержащуюся в конкретном MainMenuэлементе, можно использовать его CloneMenu метод для создания копии.If you want to reuse the menu structure contained in a specific MainMenu, you can use its CloneMenu method to create a copy. После создания копии структуры меню можно внести соответствующие изменения в новую структуру меню.Once you have a copy of the menu structure, you can make the appropriate modifications for your new menu structure.

Примечание

Вырезание и вставленные элементы меню из одной формы в другую в конструкторе могут не работать должным образом, если в форме, в которую вставляется элемент меню, не определено ни одного элемента.Cutting and pasting menu items from one form to another in the designer might not work as expected if the form you are pasting into has no menu items defined.

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

MainMenu()

Инициализирует новый экземпляр класса MainMenu без каких-либо заданных элементов меню.Initializes a new instance of the MainMenu class without any specified menu items.

MainMenu(IContainer)

Инициализирует новый экземпляр класса MainMenu с указанным контейнером.Initializes a new instance of the MainMenu class with the specified container.

MainMenu(MenuItem[])

Инициализирует новый экземпляр класса MainMenu с указанным набором объектов MenuItem.Initializes a new instance of the MainMenu with a specified set of MenuItem objects.

Поля

FindHandle

Указывает, что метод FindMenuItem(Int32, IntPtr) должен выполнять поиск дескриптора.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a handle.

(Унаследовано от Menu)
FindShortcut

Указывает, что метод FindMenuItem(Int32, IntPtr) должен выполнять поиск ярлыка.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a shortcut.

(Унаследовано от Menu)

Свойства

CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Унаследовано от Component)
Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Унаследовано от Component)
DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component)
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component)
Handle

Получает значение, представляющее дескриптор окна для меню.Gets a value representing the window handle for the menu.

(Унаследовано от Menu)
IsParent

Получает значение, показывающее, содержит ли это меню какие-нибудь элементы меню.Gets a value indicating whether this menu contains any menu items. Это свойство доступно только для чтения.This property is read-only.

(Унаследовано от Menu)
MdiListItem

Получает значение, указывающее объект MenuItem, используемый для отображения списка дочерних форм многодокументного интерфейса (MDI).Gets a value indicating the MenuItem that is used to display a list of multiple document interface (MDI) child forms.

(Унаследовано от Menu)
MenuItems

Получает значение, показывающее коллекцию объектов MenuItem, связанных с данным меню.Gets a value indicating the collection of MenuItem objects associated with the menu.

(Унаследовано от Menu)
Name

Возвращает или задает имя таблицы для объекта Menu.Gets or sets the name of the Menu.

(Унаследовано от Menu)
RightToLeft

Возвращает или устанавливает значение, указывающее, должен ли текст, выводимый на экран элементом управления, отображаться справа налево.Gets or sets whether the text displayed by the control is displayed from right to left.

Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Унаследовано от Component)
Tag

Получает или задает определяемые пользователем данные, связанные с элементом управления.Gets or sets user-defined data associated with the control.

(Унаследовано от Menu)

Методы

CloneMenu()

Создает новый объект MainMenu, который является дубликатом текущего объекта MainMenu.Creates a new MainMenu that is a duplicate of the current MainMenu.

CloneMenu(Menu)

Копирует объект Menu, передаваемый в качестве параметра в текущий объект Menu.Copies the Menu that is passed as a parameter to the current Menu.

(Унаследовано от Menu)
CreateMenuHandle()

Создает новый дескриптор для меню.Creates a new handle to the Menu.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Унаследовано от Component)
Dispose(Boolean)

Уничтожает ресурсы (кроме памяти), используемые классом MainMenu.Disposes of the resources, other than memory, used by the MainMenu.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
FindMenuItem(Int32, IntPtr)

Получает объект MenuItem, содержащий указываемое значение.Gets the MenuItem that contains the value specified.

(Унаследовано от Menu)
FindMergePosition(Int32)

Возвращает позицию меню, в которую должен быть вставлен элемент меню.Returns the position at which a menu item should be inserted into the menu.

(Унаследовано от Menu)
GetContextMenu()

Получает объект ContextMenu, содержащий это меню.Gets the ContextMenu that contains this menu.

(Унаследовано от Menu)
GetForm()

Получает объект Form, содержащий этот элемент управления.Gets the Form that contains this control.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetMainMenu()

Получает объект MainMenu, содержащий это меню.Gets the MainMenu that contains this menu.

(Унаследовано от Menu)
GetService(Type)

Возвращает объект, представляющий службу, обеспечиваемую компонентом Component или его контейнером Container.Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
MergeMenu(Menu)

Объединяет объекты MenuItem одного меню с текущим меню.Merges the MenuItem objects of one menu with the current menu.

(Унаследовано от Menu)
OnCollapse(EventArgs)

Вызывает событие Collapse.Raises the Collapse event.

ProcessCmdKey(Message, Keys)

Обрабатывает клавишу для команд.Processes a command key.

(Унаследовано от Menu)
ToString()

Возвращает строку, представляющую объект MainMenu.Returns a string that represents the MainMenu.

События

Collapse

Происходит при сворачивании главного меню.Occurs when the main menu collapses.

Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component)

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

Дополнительно