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

示例

下面的代码示例创建 一个 ，将两MenuItem个 MainMenu对象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 菜单可以是应用程序的命令，也可以是其他子菜单项的父菜单。 若要将 绑定到MainMenuForm将显示它的 ，请将 分配给 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)

属性

CanRaiseEvents	获取一个指示组件是否可以引发事件的值。 (继承自 Component)
Container	获取包含 IContainer 的 Component。 (继承自 Component)
DesignMode	获取一个值，用以指示 Component 当前是否处于设计模式。 (继承自 Component)
Events	获取附加到此 Component 的事件处理程序的列表。 (继承自 Component)
Handle	获取表示菜单的窗口句柄的值。 (继承自 Menu)
IsParent	获取一个值，通过该值指示此菜单是否包含任何菜单项。 此属性是只读的。 (继承自 Menu)
MdiListItem	获取一个值，通过该值指示用于显示多文档界面 (MDI) 子窗体列表的 MenuItem。 (继承自 Menu)
MenuItems	获取一个值，通过该值指示与菜单关联的 MenuItem 对象的集合。 (继承自 Menu)
Name	获取或设置 Menu 的名称。 (继承自 Menu)
RightToLeft	获取或设置控件显示的文本是否从右向左显示。
Site	获取或设置 Component 的 ISite。 (继承自 Component)
Tag	获取或设置与控件关联的用户定义的数据。 (继承自 Menu)

方法

CloneMenu()	创建一个新 MainMenu，它是当前 MainMenu 的副本。
CloneMenu(Menu)	复制作为参数被传递到当前 Menu 的 Menu。 (继承自 Menu)
CreateMenuHandle()	创建 Menu 的新句柄。
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 窗体）