MenuItem.CloneMenu Método

Origem:

MenuItem.cs

Origem:

MenuItem.cs

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

Exemplos

O seguinte exemplo de código inicializa um novo MenuItem com uma cópia de um existente MenuItem que é usado num MainMenu formulário. O código depois adiciona o clonado MenuItem a ContextMenu no formulário. Este exemplo exige que um MenuItem já seja criado e nomeado menuItem1 e que um ContextMenu controlo 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

Observações

Chame este método para criar cópias de itens do menu que já criou para uso num menu de atalho ou noutra estrutura de menu dentro da sua aplicação. Esta versão permite CloneMenu especificar um item específico MenuItem para copiar em vez do item do menu que está a chamar o método. Pode usar este método para inicializar um novo MenuItem objeto com uma cópia de outro MenuItem. Quando um item do menu é clonado, quaisquer gestores de eventos especificados no item original do menu continuam a funcionar na versão clonada do item do menu. Por exemplo, se criar um MenuItem evento e ligar o seu Click evento a um gestor de eventos. Quando o item do menu é clonado, o item do menu clonado chama o mesmo gestor de eventos.

Origem:

MenuItem.cs

Origem:

MenuItem.cs

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

Devoluções

A que representa o item duplicado do MenuItem menu.

Exemplos

O exemplo de código seguinte clona a MenuItem e apresenta-o num ContextMenu. O exemplo exige que a MenuItem exista em a MainMenu numa forma com o nome de menuItem1 e que um ContextMenu objeto nomeado contextMenu1 também exista na forma.

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

Observações

MenuItem Os objetos não podem ser usados em mais do que um local a menos que obtenha uma cópia do MenuItem. Pode chamar este método para criar uma cópia deste item do menu para usar num ContextMenu, MainMenu, ou outro MenuItem dentro da sua aplicação. Quando um item do menu é clonado, quaisquer gestores de eventos especificados no item original do menu continuam a funcionar na versão clonada do item do menu. Por exemplo, se criar um MenuItem evento e ligar o seu Click evento a um gestor de eventos. Quando o item do menu é clonado, o item do menu clonado chama o mesmo gestor de eventos.