This documentation is archived and is not being maintained.

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 */
public MenuMerge get_MergeType ()

/** @property */
public void set_MergeType (MenuMerge value)

public function get MergeType () : MenuMerge

public function set MergeType (value : MenuMerge)

Property Value

A MenuMerge value that represents the menu item's merge type.

Exception typeCondition

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;
}


public void InitMyFileMenu()
{
    // Set the MergeType to Add so that the menu item is
    // added to the merged menu.
    menuItem1.set_MergeType(MenuMerge.Add);

    // Set the MergeOrder to 1 so that this menu item is placed lower
    // in the merged menu order.
    menuItem1.set_MergeOrder(1);
} //InitMyFileMenu

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0
Show: