MenuItem.CloneMenu Méthode

protected:
 void CloneMenu(System::Windows::Forms::MenuItem ^ itemSrc);

protected void CloneMenu (System.Windows.Forms.MenuItem itemSrc);

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

Protected Sub CloneMenu (itemSrc As MenuItem)

Paramètres

Exemples

L’exemple de code suivant initialise un nouveau MenuItem avec une copie d’un existant MenuItem utilisé dans un MainMenu formulaire. Le code ajoute ensuite le cloné MenuItem à un ContextMenu sur le formulaire. Cet exemple nécessite qu’un MenuItem soit déjà créé et nommé menuItem1 et qu’un ContextMenu contrôle ait été créé et nommé contextMenu1.

public:
   void CloneMyMenu()
   {
      // Clone the existing MenuItem into the new MenuItem.
      MenuItem^ tempMenuItem = menuItem1->CloneMenu();
      
      // Assign the cloned MenuItem to the ContextMenu.
      contextMenu1->MenuItems->Add( tempMenuItem );
   }

public void CloneMyMenu()
{
   // Clone the existing MenuItem into the new MenuItem.
   MenuItem tempMenuItem = menuItem1.CloneMenu();
 
   // Assign the cloned MenuItem to the ContextMenu.
   contextMenu1.MenuItems.Add(tempMenuItem);
}

Public Sub CloneMyMenu()
    ' Clone the existing MenuItem into the new MenuItem.
    Dim tempMenuItem As MenuItem = menuItem1.CloneMenu()
       
    ' Assign the cloned MenuItem to the ContextMenu.
    contextMenu1.MenuItems.Add(tempMenuItem)
End Sub

Remarques

Appelez cette méthode pour créer des copies des éléments de menu que vous avez déjà créés pour une utilisation dans un menu contextuel ou une autre structure de menu au sein de votre application. Cette version de vous permet de CloneMenu spécifier un spécifique MenuItem à copier au lieu de l’élément de menu qui appelle la méthode. Vous pouvez utiliser cette méthode pour initialiser un nouvel MenuItem objet avec une copie d’un autre MenuItemobjet . Lorsqu’un élément de menu est cloné, tous les gestionnaires d’événements spécifiés dans l’élément de menu d’origine continuent à fonctionner dans la version cloné de l’élément de menu. Par exemple, si vous avez créé un MenuItem et connecté son Click événement à un gestionnaire d’événements. Lorsque l’élément de menu est cloné, l’élément de menu cloné appelle le même gestionnaire d’événements.

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

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

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

Public Overridable Function CloneMenu () As MenuItem

Retours

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

Exemples

L’exemple de code suivant clone un MenuItem et l’affiche dans un ContextMenu. L’exemple exige qu’un MenuItem existe dans un MainMenu sur un formulaire portant le nom de menuItem1 et qu’un ContextMenu objet nommé contextMenu1 existe également sur le formulaire.

public:
   void CloneMyMenu()
   {
      // Clone the menu item and add it to the collection for the shortcut menu.
      contextMenu1->MenuItems->Add( menuItem1->CloneMenu() );
   }

public void CloneMyMenu()
{
   // Clone the menu item and add it to the collection for the shortcut menu.
   contextMenu1.MenuItems.Add(menuItem1.CloneMenu());
}

Public Sub CloneMyMenu()

    ' Clone the menu item and add it to the collection for the shortcut menu.
    contextMenu1.MenuItems.Add(menuItem1.CloneMenu())
    
End Sub

Remarques

MenuItem Les objets ne peuvent pas être utilisés à plusieurs endroits, sauf si vous obtenez une copie du MenuItem. Vous pouvez appeler cette méthode pour créer une copie de cet élément de menu à utiliser dans un ContextMenu, MainMenuou autre MenuItem dans votre application. Lorsqu’un élément de menu est cloné, tous les gestionnaires d’événements spécifiés dans l’élément de menu d’origine continuent à fonctionner dans la version cloné de l’élément de menu. Par exemple, si vous avez créé un MenuItem et connecté son Click événement à un gestionnaire d’événements. Lorsque l’élément de menu est cloné, l’élément de menu cloné appelle le même gestionnaire d’événements.