Menu.MergeMenu(Menu) Menu.MergeMenu(Menu) Menu.MergeMenu(Menu) Menu.MergeMenu(Menu) Method

Definición

Combina los objetos MenuItem de un menú en el menú actual.Merges the MenuItem objects of one menu with the current menu.

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 Menu Menu Menu

Menu cuyos elementos de menú se combinan con los elementos del menú actual.The Menu whose menu items are merged with the menu items of the current menu.

Excepciones

Se intentó combinar el menú con él mismo.It was attempted to merge the menu with itself.

Ejemplos

En este ejemplo crea dos menús mainMenu1 y mainMenu2.This example creates two menus, mainMenu1 and mainMenu2. El primer menú contiene una MenuItem, File, y la segunda contiene una MenuItem, Edit.The first menu contains one MenuItem, File, and the second contains one MenuItem, Edit. Mediante el MergeMenu método mainMenu2 se combina con mainMenu1.Using the MergeMenu method, mainMenu2 is merged with mainMenu1. Cuando aparezca, mainMenu1 contendrá dos elementos de menú, File y Edit.When displayed, mainMenu1 will contain the two menu items, File and Edit. En este ejemplo requiere que se haya creado un Form denominado 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 'InitializeMyMainMenu

Comentarios

Este método combina MenuItem objetos desde un menú en el menú actual.This method merges MenuItem objects from one menu with the current menu. MenuItem los objetos se combinan según los valores de la MenuItem.MergeType y MenuItem.MergeOrder propiedades.MenuItem objects are merged according to the values of the MenuItem.MergeType and MenuItem.MergeOrder properties.

Normalmente se realiza la combinación de menús para combinar los menús de un formulario principal de interfaz de múltiples documentos (MDI) con los de su formulario MDI secundario activo.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. Esto se realiza automáticamente con .NET Framework common language runtime.This is performed automatically by the .NET Framework common language runtime. Por ejemplo, si un formulario MDI primario contiene un conjunto de menús para administrar archivos y su formulario MDI secundario también tiene elementos de menú relacionadas con archivos, los conjuntos de menú combinará automáticamente en un menú de único archivo establecer cuando el formulario secundario se muestra en el formulario primario 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.

Puede usar el MergeMenu método si desea combinar dos estructuras de menús que no forman parte de una aplicación MDI.You can use the MergeMenu method if you are merging two menu structures that are not part of an MDI application. Esta implementación puede llamarse mediante el MainMenu o ContextMenu clases para combinar dos o más objetos que derivan de Menu.This implementation can be called by the MainMenu or ContextMenu classes to merge two or more objects that derive from Menu.

Para combinar dos MenuItem objetos utilizan el MenuItem.MergeMenu método.To merge two MenuItem objects use the MenuItem.MergeMenu method.

Se aplica a

Consulte también: