DocumentManager.RibbonAndBarsMergeStyle Property

Gets or sets whether Bar Managers and Ribbon Controls from this DocumentManager‘s child Documents should be automatically merged to Bars and Ribbons in the main application form.

Namespace: DevExpress.XtraBars.Docking2010

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 child Bar Managers and Ribbon Controls 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, Bars and Ribbons from child Documents can be either automatically merged to the main form’s Bars and Ribbons whenever it is possible, or never merge. Choose the last behavior if you want to exclude this DocumentManager from merging. See the Bar and Ribbon Merging topic for the details.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the RibbonAndBarsMergeStyle property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-merge-bars-within-the-documentmanager-control-e4950/CS/DocumentManagerBarMerging/Form1.cs#L17

    tabbedView1.DocumentProperties.AllowPin = true;
    documentManager1.RibbonAndBarsMergeStyle = DevExpress.XtraBars.Docking2010.Views.RibbonAndBarsMergeStyle.Always;
}

VB.NET

how-to-merge-bars-within-the-documentmanager-control-e4950/VB/DocumentManagerBarMerging/Form1.vb#L18

    tabbedView1.DocumentProperties.AllowPin = True
    documentManager1.RibbonAndBarsMergeStyle = DevExpress.XtraBars.Docking2010.Views.RibbonAndBarsMergeStyle.Always
End Sub