Export (0) Print
Expand All

ToolStripItem.MergeIndex Property

Gets or sets the position of a merged item within the current ToolStrip.

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

public int MergeIndex { get; set; }

Property Value

Type: System.Int32
An integer representing the index of the merged item, if a match is found, or -1 if a match is not found.

Use the MergeIndex property to get or set the index of a ToolStripMenuItem so that you can access it for menu-merging operations.

The following example uses the MergeIndex property to insert a merged ToolStripMenuItem in a specific location. This example is part of a larger example available in the ToolStripManager class overview.

public void ShowInsertInSameLocationSample()
{
    // Notice how the items are in backward order.   
    // This is because "merge-one" gets applied, then a search occurs for the new second position 
    // for "merge-two", and so on.
    foreach (ToolStripItem item in cmsItemsToMerge.Items)
    {
        item.MergeAction = MergeAction.Insert;
        item.MergeIndex = 2;
    }
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft