0 out of 1 rated this helpful - Rate this topic

MenuItem.MergeType Property

.NET Framework 2.0

Other Versions

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)

Syntax

C++

Copy

public MenuMerge MergeType { get; set; }

Copy

/** @property */
public MenuMerge get_MergeType ()

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

JScript

Copy

public function get MergeType () : MenuMerge

public function set MergeType (value : MenuMerge)

Property Value

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

Exceptions

Exception type	Condition
InvalidEnumArgumentException	The assigned value is not one of the MenuMerge values.

Remarks

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.

Example

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.

C++

Copy

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

Copy

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

Platforms

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.

Version Information

.NET Framework

Supported in: 2.0, 1.1, 1.0

Reference

MenuItem Class
MenuItem Members
System.Windows.Forms Namespace
MenuMerge
MenuItem.MergeOrder Property

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ