MenuItem.MergeMenu メソッド

定義

この MenuItem と別の MenuItem をマージします。Merges this MenuItem with another MenuItem.

オーバーロード

MergeMenu(MenuItem)

別のメニュー項目とこのメニュー項目をマージします。Merges another menu item with this menu item.

MergeMenu()

この MenuItem と別の MenuItem をマージし、マージ後に作成された MenuItem を返します。Merges this MenuItem with another MenuItem and returns the resulting merged MenuItem.

MergeMenu(MenuItem)

別のメニュー項目とこのメニュー項目をマージします。Merges another menu item with this menu item.

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

このメニュー項目とマージするメニュー項目を指定する MenuItemA MenuItem that specifies the menu item to merge with this one.

次のコード例では、このバージョンMergeMenuのメソッドを使用して、 MenuItemのコピーを作成し、別のにマージします。The following code example uses this version of the MergeMenu method to create a copy of a MenuItem and merge it with another. MenuItemContextMenuに、マージされたをコントロールに追加します。The merged MenuItem is then added to a ContextMenu control. この例menuItem1では、とmenuItem2いう2つのメニュー項目があり、そこにサブメニュー項目contextMenu1と、メニュー項目を表示するという名前のContextMenuが含まれている必要があります。This example requires that there are two menu items called menuItem1 and menuItem2 that contain submenu items within them and a ContextMenu named contextMenu1 to display the menu items. menuItem1menuItem2には、それぞれ異なるメニュー項目が含まれています。menuItem1 and menuItem2 have different menu items contained within them. の呼び出しMergeMenuが行われると、統合メニューが作成されます。After the call to MergeMenu is made, a consolidated menu is created.

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プロパティの値に従ってマージされます。Menu items are merged according to the value of the menu item's MergeType and MergeOrder properties. このバージョンのMergeMenuメソッドを使用すると、2 MenuItemつのオブジェクト (およびそのサブメニュー) を1つのメニューにマージできます。This version of the MergeMenu method enables you to merge two MenuItem objects (and their submenus) into a single menu. 複数のドキュメントインターフェイス (MDI) 親フォームと子の両方にメニューがある場合、メニューのマージは自動的に処理されます。Menu merging is handled automatically when a Multiple Document Interface (MDI) parent form and a child both have menus. このバージョンのメソッドを使用すると、 MenuItem MainMenu ContextMenuコントロールに配置されている2つのオブジェクト (およびそのサブメニュー項目) を内の1つのメニューにマージできます。You can use this version of the method to merge two MenuItem objects (and their submenu items) located in a MainMenu control into a single menu within a ContextMenu. たとえば、このバージョンMergeMenuのメソッドを呼び出して、ファイルと編集メニューのメニュー項目を、に追加してContextMenu表示するMenuItemことができる単一のにマージできます。For example, you can call this version of the MergeMenu method to merge the menu items of a File and Edit menu into a single MenuItem that can then be added to and displayed by a ContextMenu.

MergeMenu()

この MenuItem と別の MenuItem をマージし、マージ後に作成された MenuItem を返します。Merges this MenuItem with another MenuItem and returns the resulting merged 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

戻り値

マージされたメニュー項目を表す MenuItemA MenuItem that represents the merged menu item.

注釈

このバージョンのMergeMenuを呼び出すと、 MenuItem現在の項目の機能に影響を与えずに別のメニュー項目とマージできる、現在のメニュー項目のコピーが返されます。When you call this version of MergeMenu, the MenuItem returned is a copy of the current menu item that can be merged with another menu item without affecting the functionality of the current item. このバージョンのMergeMenuメソッドは、 CloneMenuパラメーターを含まないメソッドを呼び出す場合と似ています。This version of the MergeMenu method is similar to calling the CloneMenu method that contains no parameters.

適用対象