Menu.MergeMenu(Menu) 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

將一個功能表的 MenuItem 物件和目前的功能表合併。

public:
 virtual void MergeMenu(System::Windows::Forms::Menu ^ menuSrc);

public virtual void MergeMenu (System.Windows.Forms.Menu menuSrc);

abstract member MergeMenu : System.Windows.Forms.Menu -> unit
override this.MergeMenu : System.Windows.Forms.Menu -> unit

Public Overridable Sub MergeMenu (menuSrc As Menu)

參數

menuSrc

Menu

Menu，它的功能表項目和目前功能表的功能表項目合併。

例外狀況

ArgumentException

嘗試將此功能表與它自己合併。

範例

此範例會建立兩個功能表和 mainMenu1mainMenu2 。 第一個功能表包含一個 MenuItem 、 File ，而第二個功能表則包含一個 MenuItem 、 Edit 。 使用 方法時 MergeMenu ， mainMenu2 會與 mainMenu1 合併。 顯示時， mainMenu1 將會包含兩個功能表項目和 FileEdit 。 此範例會要求您已建立 Form 名為 的 Form1 。

private:
   void InitializeMyMainMenu()
   {
      // Create the 2 menus and the menu items to add.
      MainMenu^ mainMenu1 = gcnew MainMenu;
      MainMenu^ mainMenu2 = gcnew MainMenu;
      MenuItem^ menuItem1 = gcnew MenuItem;
      MenuItem^ menuItem2 = gcnew MenuItem;

      // Set the caption for the menu items.
      menuItem1->Text = "File";
      menuItem2->Text = "Edit";

      // Add a menu item to each menu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
      mainMenu2->MenuItems->Add( menuItem2 );

      // Merge mainMenu2 with mainMenu1
      mainMenu1->MergeMenu( mainMenu2 );

      // Assign mainMenu1 to the form.
      this->Menu = mainMenu1;
   }

      private void InitializeMyMainMenu()
      {
          // Create the 2 menus and the menu items to add.
          MainMenu mainMenu1 = new MainMenu();
          MainMenu mainMenu2 = new MainMenu();

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

          // Set the caption for the menu items.
          menuItem1.Text = "File";
          menuItem2.Text = "Edit";

          // Add a menu item to each menu for displaying.
          mainMenu1.MenuItems.Add(menuItem1);
          mainMenu2.MenuItems.Add(menuItem2);

          // Merge mainMenu2 with mainMenu1
          mainMenu1.MergeMenu(mainMenu2);

          // Assign mainMenu1 to the form.
          this.Menu = mainMenu1;
      }

Private Sub InitializeMyMainMenu()
    ' Create the 2 menus and the menu items to add.
    Dim mainMenu1 As New MainMenu()
    Dim mainMenu2 As New MainMenu()

    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()

    ' Set the caption for the menu items.
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"

    ' Add a menu item to each menu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu2.MenuItems.Add(menuItem2)

    ' Merge mainMenu2 with mainMenu1
    mainMenu1.MergeMenu(mainMenu2)

    ' Assign mainMenu1 to the form.
    Me.Menu = mainMenu1
End Sub

備註

這個方法會將 MenuItem 物件從一個功能表與目前的功能表合併。 MenuItem物件會根據 和 MenuItem.MergeOrder 屬性的值 MenuItem.MergeType 合併。

功能表合併通常是為了合併多個檔介面的功能表， (MDI) 父表單與其作用中 MDI 子表單的功能表合併。 這會由 common Language Runtime .NET Framework自動執行。 例如，如果 MDI 父表單包含一組用於處理檔案的功能表，而您的 MDI 子表單也有檔案相關的功能表項目，則當子表單顯示在 MDI 父表單中時，功能表集會自動合併成單一檔案功能表集。

如果您要合併兩個不屬於 MDI 應用程式的功能表結構，您可以使用 MergeMenu 方法。 這個實作可由 或 ContextMenu 類別呼叫 MainMenu ，以合併衍生自 Menu 的兩個或多個 物件。

若要合併兩個 MenuItem 物件，請使用 MenuItem.MergeMenu 方法。

另請參閱

• MergeType
• MergeOrder