語言

Menu.MergeMenu(Menu) 方法

定義

將 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 菜單項目會與當前菜單的項目合併。

例外狀況

他們嘗試將選單與自身合併。

範例

此範例會產生兩個選單,且 mainMenu1mainMenu2。 第一個選單包含一個 MenuItem, File, ,第二個選單包含一個 MenuItem, Edit。 使用該 MergeMenu 方法,與 mainMenu2 合併 mainMenu1。 顯示時, mainMenu1 將包含兩個選單項目, File 且 Edit。 這個範例需要你建立了一個 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.MergeTypeMenuItem.MergeOrder 屬性的值合併。

選單合併通常是為了將多文件介面(MDI)父表單的選單與其活躍的 MDI 子表單合併。 此操作由 .NET Framework 通用語言執行時自動執行。 例如,若 MDI 父表單包含一組用於處理檔案的選單,且您的 MDI 子表單也有與檔案相關的選單項目,當子表單顯示於 MDI 父表單時,這些選單集會自動合併成單一檔案選單集。

如果你要合併兩個不屬於 MDI 應用程式的選單結構,也可以用這個 MergeMenu 方法。 此實作可由 MainMenu or ContextMenu 類別呼叫,以合併兩個或多個源自 Menu的物件。

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

適用於

另請參閱