RibbonPage.MergeOrder Property

Defines the visual position of the current RibbonPage object after merging this Ribbon Control into an MDI parent Ribbon.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v24.2.dll

Declaration

C#

[DefaultValue(-1)]
[XtraSerializableProperty]
public int MergeOrder { get; set; }

VB.NET

<DefaultValue(-1)>
<XtraSerializableProperty>
Public Property MergeOrder As Integer

Property Value

Type	Default	Description
Int32	-1	An ordinal number determining the position of the RibbonPage after merging this Ribbon Control into an MDI parent Ribbon.

Remarks

In MDI applications, Ribbon Controls can be merged as specified by the RibbonControl.MdiMergeStyle property.

By default, after merging, the RibbonPage, RibbonPageCategory and RibbonPageGroup objects belonging to a child Ribbon Control are displayed after the corresponding objects of the parent RibbonControl. The MergeOrder property allows you to override this default behavior. This property specifies the position at which the Ribbon objects are displayed among the same-type objects after merging. Objects with the lowest MergeOrder come first. The last objects will be those that have the greatest MergeOrder value. If a parent form’s Ribbon has objects with a MergeOrder equal to the MergeOrder of a child form’s Ribbon objects, then the child form’s objects will be placed after all the parent form’s matching objects.

Note

Specifying the MergeOrder property for bar items within the Ribbon is not supported.

Note

Pages with the MergeOrder property set to negative values are not taken into account by Ribbon Control and placed after other pages involved in the merging process.