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
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.