MenuItem.MergeMenu 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

合併這個 MenuItem 和另一 MenuItem。

多載

MergeMenu(MenuItem)	合併這個功能表項目與另一功能表項目。
MergeMenu()	這個 MenuItem 和另一 MenuItem 合併後傳回合併產生的 MenuItem。

MergeMenu(MenuItem)

合併這個功能表項目與另一功能表項目。

public:
 void MergeMenu(System::Windows::Forms::MenuItem ^ itemSrc);

public void MergeMenu (System.Windows.Forms.MenuItem itemSrc);

override this.MergeMenu : System.Windows.Forms.MenuItem -> unit

Public Sub MergeMenu (itemSrc As MenuItem)

參數

itemSrc

MenuItem

MenuItem，指定和這個功能表項目合併的功能表項目。

範例

下列程式碼範例會使用這個版本的 MergeMenu 方法來建立 的 MenuItem 複本，並將其與另一個複本合併。 然後，合併 MenuItem 的 會新增至 ContextMenu 控制項。 此範例要求有兩個稱為 menuItem1 的功能表項目，其中包含 menuItem2 其中子功能表項，以及 ContextMenu 用來顯示功能表項目的具名 contextMenu1 。 menuItem1 和 menuItem2 包含于其中的不同功能表項目。 呼叫 MergeMenu 之後，就會建立合併功能表。

private:
   void MergeMyMenus()
   {
      // Set the merge type to merge the items from both top menu items.
      menuItem1->MergeType = MenuMerge::MergeItems;
      menuItem2->MergeType = MenuMerge::MergeItems;
      // Create a copy of my menu item.
      MenuItem^ tempMenuItem = gcnew MenuItem;
      // Create a copy of menuItem1 before doing the merge.
      tempMenuItem = menuItem1->CloneMenu();
      // Merge menuItem1's copy with a clone of menuItem2
      tempMenuItem->MergeMenu( menuItem2->CloneMenu() );
      
      // Add the merged menu to the ContextMenu control.
      contextMenu1->MenuItems->Add( tempMenuItem );
   }

private void MergeMyMenus()
{
   // Set the merge type to merge the items from both top menu items.
   menuItem1.MergeType = MenuMerge.MergeItems;
   menuItem2.MergeType = MenuMerge.MergeItems;
   // Create a copy of my menu item.
   MenuItem tempMenuItem = new MenuItem();
   // Create a copy of menuItem1 before doing the merge.
   tempMenuItem = menuItem1.CloneMenu();
   // Merge menuItem1's copy with a clone of menuItem2
   tempMenuItem.MergeMenu(menuItem2.CloneMenu());

   // Add the merged menu to the ContextMenu control.
   contextMenu1.MenuItems.Add(tempMenuItem);
}

Private Sub MergeMyMenus()
    ' Set the merge type to merge the items from both top menu items.
    menuItem1.MergeType = MenuMerge.MergeItems
    menuItem2.MergeType = MenuMerge.MergeItems
    ' Create a copy of my menu item.
    Dim tempMenuItem As New MenuItem()
    ' Create a copy of menuItem1 before doing the merge.
    tempMenuItem = menuItem1.CloneMenu()
    ' Merge menuItem1's copy with a clone of menuItem2
    tempMenuItem.MergeMenu(menuItem2.CloneMenu())
       
    ' Add the merged menu to the ContextMenu control.
    contextMenu1.MenuItems.Add(tempMenuItem)
End Sub

備註

功能表項目會根據功能表項目 MergeType 和 MergeOrder 屬性的值合併。 這個版本的 MergeMenu 方法可讓您將兩 MenuItem 個物件 (及其子) 功能表合併成單一功能表。 當多個檔介面 (MDI) 父表單和子系都有功能表時，會自動處理功能表合併。 您可以使用這個版本的 方法，將兩 MenuItem 個物件合併 (及其子功能表項，) 位於 控制項內的 ContextMenu 單一 MainMenu 功能表。 例如，您可以呼叫這個版本的 MergeMenu 方法，將 [檔案] 和 [編輯] 功能表的功能表項目合併成單 MenuItem 一，然後由 新增和顯示 ContextMenu 。

MergeMenu()

這個 MenuItem 和另一 MenuItem 合併後傳回合併產生的 MenuItem。

public:
 virtual System::Windows::Forms::MenuItem ^ MergeMenu();

public virtual System.Windows.Forms.MenuItem MergeMenu ();

override this.MergeMenu : unit -> System.Windows.Forms.MenuItem

Public Overridable Function MergeMenu () As MenuItem

傳回

MenuItem

MenuItem，表示合併的功能表項目。

備註

當您呼叫這個版本的 MergeMenu 時， MenuItem 傳回的 是目前功能表項目的複本，可以與另一個功能表項目合併，而不會影響目前專案的功能。 這個版本的 MergeMenu 方法類似于呼叫 CloneMenu 不包含任何參數的方法。