DockLayoutManager.MDIMergeStyle Property
Gets or sets if and when the merge mechanism is invoked by the DockLayoutManager.
Namespace: DevExpress.Xpf.Docking
Assembly: DevExpress.Xpf.Docking.v24.2.dll
NuGet Package: DevExpress.Wpf.Docking
#Declaration
public MDIMergeStyle MDIMergeStyle { get; set; }
#Property Value
Type | Description |
---|---|
MDIMerge |
An MDIMerge |
Available values:
Name | Description |
---|---|
Default | Identical to the MDIMerge |
When |
Bars/ribbons are merged in the following cases:
Bars/ribbons are unmerged in the following cases:
|
Always | The panel’s bar/ribbon is merged with the parent bar/ribbon in the following cases:
If your layout contains multiple Document Bars/ribbons are unmerged in the following cases:
|
Never | Prevents all child tabbed and MDI panels from being merged. |
When |
Similar to When |
#Remarks
A DockLayoutManager supports merging Bars, RibbonControls and RibbonStatusBarControls of child panels with the main panel’s Bars, RibbonControls and RibbonStatusBarControls. In regular MDI mode, by default, these controls are merged when a child MDI panel is maximized. In tabbed MDI mode, (when the host group’s DocumentGroup.MDIStyle property is set to Tabbed), the merging is performed when a tab is activated. Selecting another tab unmerges the previous tab and merges the newly selected one.
The MDIMergeStyle property allows you to specify when the merging/unmerging mechanism is invoked. This property is applied to all child panels within the current DockLayoutManager. Use the DocumentPanel.MDIMergeStyle property to override this setting for individual panels.
It is also possible to prevent Bars, RibbonControls or RibbonStatusBars from being merged by setting the BarManager.MDIMergeStyle, RibbonControl.MDIMergeStyle or RibbonStatusBarControl.MDIMergeStyle property to MDIMergeStyle.Never.
The following code shows how to restrict merging for one specified panel and allow it for all the others:
xmlns:dxdo="http://schemas.devexpress.com/winfx/2008/xaml/docking"
<dxdo:DockLayoutManager x:Name="dockManager" MDIMergeStyle="Always">
<dxdo:LayoutGroup>
<dxdo:DocumentGroup Name="mdiContainer" MDIStyle="MDI">
<dxdo:DocumentPanel Name="unmergedPanel"
Caption="This Panel Never Invokes The Merging Mechanism"
Content="..."
MDILocation="250,100"
MDIMergeStyle="Never"
MDISize="500,300" />
<dxdo:DocumentPanel Name="mergedPanel"
Caption="This Panel Is Merged When Maximized"
Content="..."
MDILocation="150,150"
MDISize="500,300" />
</dxdo:DocumentGroup>
</dxdo:LayoutGroup>
</dxdo:DockLayoutManager>