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

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