MenuItem.MergeMenu Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fusionne ce MenuItem avec un autre MenuItem.

Surcharges

MergeMenu(MenuItem)	Fusionne un autre élément de menu avec cet élément.
MergeMenu()	Fusionne ce MenuItem avec un autre MenuItem et retourne le MenuItem qui résulte de la fusion.

MergeMenu(MenuItem)

Fusionne un autre élément de menu avec cet élément.

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)

Paramètres

itemSrc

MenuItem

MenuItem qui spécifie l'élément de menu à fusionner avec celui-ci.

Exemples

L’exemple de code suivant utilise cette version de la MergeMenu méthode pour créer une copie d’un et le fusionner avec une MenuItem autre. Le fusionné MenuItem est ensuite ajouté à un ContextMenu contrôle. Cet exemple nécessite que deux éléments de menu soient appelés menuItem1 et menuItem2 contiennent des éléments de sous-menu et un ContextMenu nommé contextMenu1 pour afficher les éléments de menu. menuItem1 et menuItem2 ont différents éléments de menu contenus dans ceux-ci. Une fois l’appel à MergeMenu effectué, un menu consolidé est créé.

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

Remarques

Les éléments de menu sont fusionnés en fonction de la valeur des propriétés et MergeOrder de l’élément de MergeType menu. Cette version de la MergeMenu méthode vous permet de fusionner deux MenuItem objets (et leurs sous-menus) dans un seul menu. La fusion de menus est gérée automatiquement lorsqu’un formulaire parent MDI (Multiple Document Interface) et un enfant ont tous deux des menus. Vous pouvez utiliser cette version de la méthode pour fusionner deux MenuItem objets (et leurs éléments de sous-menu) situés dans un MainMenu contrôle en un seul menu dans un ContextMenu. Par exemple, vous pouvez appeler cette version de la MergeMenu méthode pour fusionner les éléments de menu d’un menu Fichier et Modifier en un seul MenuItem qui peut ensuite être ajouté à et affiché par un ContextMenu.

MergeMenu()

Fusionne ce MenuItem avec un autre MenuItem et retourne le MenuItem qui résulte de la fusion.

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

Retours

MenuItem

MenuItem qui représente l'élément de menu fusionné.

Remarques

Lorsque vous appelez cette version de MergeMenu, le MenuItem retourné est une copie de l’élément de menu actif qui peut être fusionné avec un autre élément de menu sans affecter les fonctionnalités de l’élément actif. Cette version de la MergeMenu méthode est similaire à l’appel de la CloneMenu méthode qui ne contient aucun paramètre.