Skip to main content
A newer version of this page is available. .

RibbonControl.MergeRibbon(RibbonControl) Method

Merges the specified Ribbon Control into the current RibbonControl.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

public virtual void MergeRibbon(
    RibbonControl ribbon
)

Parameters

Name Type Description
ribbon RibbonControl

A RibbonControl to be merged into the current RibbonControl.

Remarks

In MDI applications, Ribbon Controls support automatic merging. The RibbonControl.MdiMergeStyle property of the main MDI form specifies whether automatic merging is enabled, and if so, when the merge and unmerge mechanisms are invoked. If automatic merging is disabled, Ribbon Controls can be merged and unmerged manually via the MergeRibbon and RibbonControl.UnMergeRibbon methods.

The BarItem.MergeType properties of bar items in main and child MDI forms define how the items behave during merge operations: whether the child form’s items replace the main form’s items, or are simply appended to the parent form’s Ribbon Control/status bar, etc.

See Ribbon Merging to learn more.

The following code snippets (auto-collected from DevExpress Examples) contain references to the MergeRibbon(RibbonControl) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also