Export (0) Print
Expand All

MenuItem.MergeType Property

Gets or sets a value indicating the behavior of this menu item when its menu is merged with another.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public MenuMerge MergeType { get; set; }

Property Value

Type: System.Windows.Forms.MenuMerge
A MenuMerge value that represents the menu item's merge type.

ExceptionCondition
InvalidEnumArgumentException

The assigned value is not one of the MenuMerge values.

The merge type of a menu item indicates how the menu item behaves when it has the same merge order as another menu item being merged. You can use merged menus to create a consolidated menu based on two or more existing menus.

The following code example creates a MenuItem with the MergeType and MergeOrder specified so that the menu item is added to the merged menu at first position.

public void InitMyFileMenu()
{
   // Set the MergeType to Add so that the menu item is added to the merged menu.
   menuItem1.MergeType = MenuMerge.Add;
   // Set the MergeOrder to 1 so that this menu item is placed lower in the merged menu order.
   menuItem1.MergeOrder = 1;
}

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2015 Microsoft