Menu.MergeMenu(Menu) Método
Definição
public:
virtual void MergeMenu(System::Windows::Forms::Menu ^ menuSrc);
public virtual void MergeMenu (System.Windows.Forms.Menu menuSrc);
abstract member MergeMenu : System.Windows.Forms.Menu -> unit
override this.MergeMenu : System.Windows.Forms.Menu -> unit
Public Overridable Sub MergeMenu (menuSrc As Menu)
Parâmetros
- menuSrc
- Menu
O Menu cujos itens de menu são mesclados com os itens de menu do menu atual.The Menu whose menu items are merged with the menu items of the current menu.
Exceções
Houve tentativa de mesclar um menu com ele mesmo.It was attempted to merge the menu with itself.
Exemplos
Este exemplo cria dois menus mainMenu1 e mainMenu2 .This example creates two menus, mainMenu1 and mainMenu2. O primeiro menu contém um MenuItem , File e o segundo contém um MenuItem , Edit .The first menu contains one MenuItem, File, and the second contains one MenuItem, Edit. O uso do MergeMenu método mainMenu2 é mesclado com mainMenu1 .Using the MergeMenu method, mainMenu2 is merged with mainMenu1. Quando exibido, mainMenu1 conterá os dois itens de menu File e Edit .When displayed, mainMenu1 will contain the two menu items, File and Edit. Este exemplo requer que você tenha criado um Form nome Form1 .This example requires that you have created a Form named Form1.
private:
void InitializeMyMainMenu()
{
// Create the 2 menus and the menu items to add.
MainMenu^ mainMenu1 = gcnew MainMenu;
MainMenu^ mainMenu2 = gcnew MainMenu;
MenuItem^ menuItem1 = gcnew MenuItem;
MenuItem^ menuItem2 = gcnew MenuItem;
// Set the caption for the menu items.
menuItem1->Text = "File";
menuItem2->Text = "Edit";
// Add a menu item to each menu for displaying.
mainMenu1->MenuItems->Add( menuItem1 );
mainMenu2->MenuItems->Add( menuItem2 );
// Merge mainMenu2 with mainMenu1
mainMenu1->MergeMenu( mainMenu2 );
// Assign mainMenu1 to the form.
this->Menu = mainMenu1;
}
private void InitializeMyMainMenu()
{
// Create the 2 menus and the menu items to add.
MainMenu mainMenu1 = new MainMenu();
MainMenu mainMenu2 = new MainMenu();
MenuItem menuItem1 = new MenuItem();
MenuItem menuItem2 = new MenuItem();
// Set the caption for the menu items.
menuItem1.Text = "File";
menuItem2.Text = "Edit";
// Add a menu item to each menu for displaying.
mainMenu1.MenuItems.Add(menuItem1);
mainMenu2.MenuItems.Add(menuItem2);
// Merge mainMenu2 with mainMenu1
mainMenu1.MergeMenu(mainMenu2);
// Assign mainMenu1 to the form.
this.Menu = mainMenu1;
}
Private Sub InitializeMyMainMenu()
' Create the 2 menus and the menu items to add.
Dim mainMenu1 As New MainMenu()
Dim mainMenu2 As New MainMenu()
Dim menuItem1 As New MenuItem()
Dim menuItem2 As New MenuItem()
' Set the caption for the menu items.
menuItem1.Text = "File"
menuItem2.Text = "Edit"
' Add a menu item to each menu for displaying.
mainMenu1.MenuItems.Add(menuItem1)
mainMenu2.MenuItems.Add(menuItem2)
' Merge mainMenu2 with mainMenu1
mainMenu1.MergeMenu(mainMenu2)
' Assign mainMenu1 to the form.
Me.Menu = mainMenu1
End Sub
Comentários
Esse método mescla MenuItem objetos de um menu com o menu atual.This method merges MenuItem objects from one menu with the current menu. MenuItem os objetos são mesclados de acordo com os valores MenuItem.MergeType das MenuItem.MergeOrder Propriedades e.MenuItem objects are merged according to the values of the MenuItem.MergeType and MenuItem.MergeOrder properties.
A mesclagem de menu normalmente é feita para mesclar os menus de um formulário pai MDI (interface de vários documentos) com aqueles de seu formulário filho MDI ativo.Menu merging is typically done to merge the menus of a Multiple Document Interface (MDI) parent form with those of its active MDI child form. Isso é executado automaticamente pelo Common Language Runtime de .NET Framework.This is performed automatically by the .NET Framework common language runtime. Por exemplo, se um formulário pai MDI contiver um conjunto de menus para manipulação de arquivos e seu formulário filho MDI também tiver itens de menu relacionados a arquivo, os conjuntos de menus serão mesclados automaticamente em um único menu de arquivo definido quando o formulário filho for exibido no formulário pai MDI.For example, if an MDI parent form contains a set of menus for handling files and your MDI child form also has file-related menu items, the menu sets will automatically merge into a single file menu set when the child form is displayed in the MDI parent form.
Você pode usar o MergeMenu método se estiver mesclando duas estruturas de menu que não fazem parte de um aplicativo MDI.You can use the MergeMenu method if you are merging two menu structures that are not part of an MDI application. Essa implementação pode ser chamada pelas MainMenu classes ou ContextMenu para mesclar dois ou mais objetos que derivam de Menu .This implementation can be called by the MainMenu or ContextMenu classes to merge two or more objects that derive from Menu.
Para mesclar dois MenuItem objetos, use o MenuItem.MergeMenu método.To merge two MenuItem objects use the MenuItem.MergeMenu method.