Skip to main content

RibbonControl.MergedRibbon Property

Gets the RibbonControl that has been merged into the current RibbonControl object.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[Browsable(false)]
public RibbonControl MergedRibbon { get; }

Property Value

Type Description
RibbonControl

A RibbonControl object that has been merged with the current RibbonControl object.

Remarks

Ribbon Control objects support bar command merging within MDI applications. The MergedRibbon property allows you to get the Ribbon Control that has been merged into the current Ribbon Control object.

Note

When merging, copies of a child RibbonControl’s categories, pages and page groups are added to the main RibbonControl, not these objects themselves. So, after Ribbon Controls have been merged, do not access merged objects via the MergedRibbon property. Instead, use the RibbonControl.MergedCategories, RibbonControl.MergedPages and RibbonPage.MergedGroups properties or Merged… properties provided by Ribbon category and page objects.

For instance, to activate a specific merged page, locate it in the RibbonControl.MergedPages or RibbonPageCategory.MergedPages collection and assign it to the RibbonControl.SelectedPage property.

A child RibbonControl’s bar items are also copied during merging. The copies are not added to separate collections. Instead, they are added directly to the RibbonPageGroup.ItemLinks, RibbonQuickAccessToolbar.ItemLinks, RibbonStatusBar.ItemLinks and RibbonControl.PageHeaderItemLinks collections.

See Ribbon Merging to learn more.

See Also