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.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

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

VB.NET

<DefaultValue(RibbonAndBarsMergeStyle.Default)>
<DXCategory("Behavior")>
Public Property RibbonAndBarsMergeStyle As RibbonAndBarsMergeStyle

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. The Document Manager/Navigation Frame control does not affect this process.
Always	Bar and Ribbon controls in child Documents/NavigationPages merge to Bar and Ribbon controls in a parent application form whenever possible.
WhenNotFloating	Documents docked as tabs merge their Bar and Ribbon controls, whereas floating Documents do not. This mode is meant to be used only for Document Manager since Navigation Frame pages never float.

Remarks

Depending on the RibbonAndBarsMergeStyle property value, Ribbons and Bars within NavigationPages owned by this NavigationFrame can be merged with Ribbons and Bars located on the parent application form. NavigationFrame merges Bars and Ribbons in the same way the Application UI Manager does; see this help topic for more details: Bar and Ribbon Merging.

The RibbonAndBarsMergeStyle property can accept the following values:

• Default - merging is controlled by Bars and Ribbons themselves - the Frame does not affect this process;
• Always - always merge child Bars and Ribbons, if the BarManager.MdiMenuMergeStyle (RibbonControl.MdiMergeStyle) does not equal Never or Default.
• WhenNotFloating - has no effect for the NavigationFrame. This mode can be used only for the MDI setup built with the Document Manager component.