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

Definizione

Unisce gli oggetti MenuItem di un menu con il menu corrente.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)

Parametri

menuSrc
Menu Menu Menu Menu

L'oggetto Menu le cui voci di menu sono unite con le voci del menu corrente.The Menu whose menu items are merged with the menu items of the current menu.

Eccezioni

È stato effettuato un tentativo di unire il menu a se stesso.It was attempted to merge the menu with itself.

Esempi

Questo esempio vengono creati due menu, mainMenu1 e mainMenu2.This example creates two menus, mainMenu1 and mainMenu2. Il primo menu contiene una MenuItem, File, e il secondo ne contiene uno MenuItem, Edit.The first menu contains one MenuItem, File, and the second contains one MenuItem, Edit. Usando il MergeMenu metodo mainMenu2 unito con mainMenu1.Using the MergeMenu method, mainMenu2 is merged with mainMenu1. Quando è visualizzata mainMenu1 conterrà due voci di menu, File e Edit.When displayed, mainMenu1 will contain the two menu items, File and Edit. Nell'esempio si presuppone che sia stato creato un Form denominato 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

Commenti

Questo metodo consente di unire MenuItem gli oggetti di un menu con menu corrente.This method merges MenuItem objects from one menu with the current menu. MenuItem gli oggetti vengono uniti in base ai valori del MenuItem.MergeType e MenuItem.MergeOrder proprietà.MenuItem objects are merged according to the values of the MenuItem.MergeType and MenuItem.MergeOrder properties.

Unione di menu viene eseguita generalmente per unire i menu di un form padre di interfaccia a documenti multipli (MDI) con quelle del relativo form figlio MDI attivo.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. Viene eseguita automaticamente da .NET Framework common language runtime.This is performed automatically by the .NET Framework common language runtime. Ad esempio, se un form padre MDI contiene un set di menu per la gestione dei file e i form figlio MDI ha anche voci di menu relative ai file, i set di menu unirà automaticamente in un menu a singolo file impostato quando il form figlio viene visualizzato nel form padre 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.

È possibile usare il MergeMenu metodo se si uniscono due strutture di menu che non fanno parte di un'applicazione MDI.You can use the MergeMenu method if you are merging two menu structures that are not part of an MDI application. Questa implementazione può essere chiamata dal MainMenu oppure ContextMenu classi per unire due o più oggetti che derivano da Menu.This implementation can be called by the MainMenu or ContextMenu classes to merge two or more objects that derive from Menu.

Per unire due MenuItem agli oggetti usano il MenuItem.MergeMenu (metodo).To merge two MenuItem objects use the MenuItem.MergeMenu method.

Si applica a

Vedi anche