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 都可以是應用程式的命令，或是其他子功能表專案的父功能表。 若要將 系結 MainMenu 至 Form 將顯示它的 ，請將 指派 MainMenu 給 Menu 的 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	取得值，表示功能表的視窗控制代碼 (Window 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()	為功能表建立新的控制代碼。
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 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()	擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 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 Form)