MenuItem.CloneMenu Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Cria uma cópia de um MenuItem.

Sobrecargas

CloneMenu(MenuItem)	Cria uma cópia do MenuItem especificado.
CloneMenu()	Cria uma cópia das MenuItem atuais.

CloneMenu(MenuItem)

Cria uma cópia do MenuItem especificado.

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)

Parâmetros

itemSrc

MenuItem

O MenuItem que representa o item de menu a ser copiado.

Exemplos

O exemplo de código a seguir inicializa um novo MenuItem com uma cópia de um existente MenuItem que é usado em um MainMenu em um formulário. Em seguida, o código adiciona o clonado MenuItem a um ContextMenu no formulário. Este exemplo requer que um MenuItem já tenha sido criado e nomeado menuItem1 e que um ContextMenu controle tenha sido criado e nomeado 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

Comentários

Chame esse método para criar cópias de itens de menu que você já criou para uso em um menu de atalho ou em outra estrutura de menu dentro do aplicativo. Esta versão do CloneMenu permite que você especifique um específico MenuItem para copiar em vez do item de menu que está chamando o método . Você pode usar esse método para inicializar um novo MenuItem objeto com uma cópia de outro MenuItem. Quando um item de menu é clonado, todos os manipuladores de eventos especificados no item de menu original continuarão a funcionar na versão clonada do item de menu. Por exemplo, se você criou um MenuItem e conectou seu Click evento a um manipulador de eventos. Quando o item de menu for clonado, o item de menu clonado chamará o mesmo manipulador de eventos.

CloneMenu()

Cria uma cópia das MenuItem atuais.

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

Retornos

MenuItem

Um MenuItem que representa o item de menu duplicado.

Exemplos

O exemplo de código a seguir clona um MenuItem e o exibe em um ContextMenu. O exemplo requer que exista um MenuItem em um MainMenu formulário com o nome de menuItem1 e que um ContextMenu objeto chamado contextMenu1 também exista no formulário.

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

Comentários

MenuItem os objetos não podem ser usados em mais de um local, a menos que você obtenha uma cópia do MenuItem. Você pode chamar esse método para criar uma cópia deste item de menu para uso em um ContextMenu, MainMenuou em outro MenuItem dentro de seu aplicativo. Quando um item de menu é clonado, todos os manipuladores de eventos especificados no item de menu original continuarão a funcionar na versão clonada do item de menu. Por exemplo, se você criou um MenuItem e conectou seu Click evento a um manipulador de eventos. Quando o item de menu for clonado, o item de menu clonado chamará o mesmo manipulador de eventos.