A newer version of this page is available. Switch to the current version.

NavigationFrame.RibbonAndBarsMergeStyle Property

Gets or sets whether or not Bar Managers and Ribbon Controls from this NavigationFrame's child pages should be automatically merged to Bars and Ribbons in the main application form.

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v19.2.dll

Declaration

[DefaultValue(RibbonAndBarsMergeStyle.Default)]
[DXCategory("Behavior")]
public RibbonAndBarsMergeStyle RibbonAndBarsMergeStyle { get; set; }

Property Value

Type Default Description
RibbonAndBarsMergeStyle

Default

A RibbonAndBarsMergeStyle enumerator value that specifies whether or not Bar Managers and Ribbon Controls from this NavigationFrame's child pages should be automatically merged to Bars and Ribbons in the main application form.

Available values:

Name Description
Default

Ribbon/Bar merging is managed by the RibbonControls/BarManagers themselves, rather than the Document Manager.

Always

Bar and Ribbon controls in child Documents will merge to Bar and Ribbon controls in a parent application form whenever it's possible.

WhenNotFloating

Bar and Ribbon controls in child Documents will always be merged, unless these Documents are floating.

Remarks

Depending on the RibbonAndBarsMergeStyle property value, Ribbons and Bars within NavigationPages hosted within this NavigationFrame can be merged with Ribbons and Bars located on the application form. NavigationFrame merging mechanics are identical to Application UI Manager merging. See the Bar and Ribbon Merging topic to learn more.

The RibbonAndBarsMergeStyle property can accept the following values:

  • RibbonAndBarsMergeStyle.Default - merging is controlled by Bars and Ribbons themselves - the frame does not affect this process;
  • RibbonAndBarsMergeStyle.Always - merge child Bars and Ribbons, if this is allowed. Thus, even if the RibbonAndBarsMergeStyle property is set to Always, automatic merging requires the BarManager.MdiMenuMergeStyle property (RibbonControl.MdiMergeStyle property for a Ribbon) to be set to a value different from Never or Default.
See Also