MenuItem.MergeMenu Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| MergeMenu(MenuItem) |
Объединяет другой пункт меню с этим элементом меню. |
| MergeMenu() |
Объединяет это MenuItem с другим MenuItem и возвращает результирующий объединенный MenuItem. |
MergeMenu(MenuItem)
- Исходный код:
- MenuItem.cs
- Исходный код:
- MenuItem.cs
Объединяет другой пункт меню с этим элементом меню.
public:
void MergeMenu(System::Windows::Forms::MenuItem ^ itemSrc);
public void MergeMenu(System.Windows.Forms.MenuItem itemSrc);
override this.MergeMenu : System.Windows.Forms.MenuItem -> unit
Public Sub MergeMenu (itemSrc As MenuItem)
Параметры
Примеры
В следующем примере кода используется эта версия MergeMenu метода, чтобы создать копию MenuItem и объединить ее с другой. Затем объединение MenuItem добавляется в ContextMenu элемент управления. В этом примере требуется, чтобы в них были вызваны menuItem1 два пункта меню, а menuItem2 в них содержатся элементы подменю, а также именованный ContextMenucontextMenu1 для отображения элементов меню.
menuItem1 и menuItem2 имеют различные элементы меню, содержащиеся в них. После вызова MergeMenu создается консолидированное меню.
private:
void MergeMyMenus()
{
// Set the merge type to merge the items from both top menu items.
menuItem1->MergeType = MenuMerge::MergeItems;
menuItem2->MergeType = MenuMerge::MergeItems;
// Create a copy of my menu item.
MenuItem^ tempMenuItem = gcnew MenuItem;
// Create a copy of menuItem1 before doing the merge.
tempMenuItem = menuItem1->CloneMenu();
// Merge menuItem1's copy with a clone of menuItem2
tempMenuItem->MergeMenu( menuItem2->CloneMenu() );
// Add the merged menu to the ContextMenu control.
contextMenu1->MenuItems->Add( tempMenuItem );
}
private void MergeMyMenus()
{
// Set the merge type to merge the items from both top menu items.
menuItem1.MergeType = MenuMerge.MergeItems;
menuItem2.MergeType = MenuMerge.MergeItems;
// Create a copy of my menu item.
MenuItem tempMenuItem = new MenuItem();
// Create a copy of menuItem1 before doing the merge.
tempMenuItem = menuItem1.CloneMenu();
// Merge menuItem1's copy with a clone of menuItem2
tempMenuItem.MergeMenu(menuItem2.CloneMenu());
// Add the merged menu to the ContextMenu control.
contextMenu1.MenuItems.Add(tempMenuItem);
}
Private Sub MergeMyMenus()
' Set the merge type to merge the items from both top menu items.
menuItem1.MergeType = MenuMerge.MergeItems
menuItem2.MergeType = MenuMerge.MergeItems
' Create a copy of my menu item.
Dim tempMenuItem As New MenuItem()
' Create a copy of menuItem1 before doing the merge.
tempMenuItem = menuItem1.CloneMenu()
' Merge menuItem1's copy with a clone of menuItem2
tempMenuItem.MergeMenu(menuItem2.CloneMenu())
' Add the merged menu to the ContextMenu control.
contextMenu1.MenuItems.Add(tempMenuItem)
End Sub
Комментарии
Элементы меню объединяются в соответствии со значением и MergeType свойствами элемента MergeOrder меню. Эта версия MergeMenu метода позволяет объединить два MenuItem объекта (и их подменю) в одно меню. Объединение меню обрабатывается автоматически, когда родительская форма интерфейса нескольких документов (MDI) и дочерний элементы имеют меню. Эту версию метода можно использовать для объединения двух MenuItem объектов (и их вложенных элементов), расположенных в элементе управления в MainMenu одном меню в пределах.ContextMenu Например, можно вызвать эту версию MergeMenu метода, чтобы объединить элементы меню меню меню "Файл" и "Изменить" в один MenuItem , в который затем можно добавить и отобразить ContextMenuего.
Применяется к
MergeMenu()
- Исходный код:
- MenuItem.cs
- Исходный код:
- MenuItem.cs
public:
virtual System::Windows::Forms::MenuItem ^ MergeMenu();
public virtual System.Windows.Forms.MenuItem MergeMenu();
override this.MergeMenu : unit -> System.Windows.Forms.MenuItem
Public Overridable Function MergeMenu () As MenuItem
Возвращаемое значение
Объект MenuItem , представляющий объединенный элемент меню.
Комментарии
При вызове этой версии MergeMenuMenuItem возвращенная копия текущего элемента меню, которую можно объединить с другим элементом меню, не затрагивая функциональные возможности текущего элемента. Эта версия MergeMenu метода аналогична вызову CloneMenu метода, содержащего параметры.