Skip to main content
A newer version of this page is available. .
Bar

MDIMergeStyle Enum

Provides members used to specify what child DocumentPanels invoke the merging/unmerging mechanism.

Namespace: DevExpress.Xpf.Bars

Assembly: DevExpress.Xpf.Core.v19.1.dll

Declaration

public enum MDIMergeStyle

Members

Name Description
Default

Identical to the MDIMergeStyle.Always value.

WhenChildActivated

The merging mechanism is invoked when a maximized MDI child panel is activated. In the case of a tabbed UI, the merging mechanism is invoked when a selected tab is activated.

The unmerge mechanism is invoked when a maximized MDI child panel is restored from the maximized state to the normal state, or when it is deactivated. In the case of a tabbed UI, the unmerge mechanism is invoked when a selected tab is deselected or deactivated.

Always

The merging mechanism is invoked when an MDI child panel is maximized in a DocumentGroup. In the case of a tabbed UI, it is invoked when a tab is selected in a DocumentGroup. If there are multiple DocumentGroups, the merging mechanism is invoked for all DocumentGroups simultaneously, thus all of them are merged to the parent at the same time.

The unmerge mechanism is invoked when an MDI child panel is restored from the maximized state to the normal state, or in case of the Tabbed UI, when another tab is selected.

Never

Prevents all child tabbed and MDI panels from being merged.

WhenLoadedOrChildActivated

Similar to the WhenChildActivated mode. Additionally, merges those MDI panels and tabs that are initially maximized (docked), but not yet selected (e.g., on application start).

Related API Members

Remarks

MDIMergeStyle enumerator values are used to set the DockLayoutManager.MDIMergeStyle, DocumentPanel.MDIMergeStyle, BarManager.MDIMergeStyle, RibbonControl.MDIMergeStyle and RibbonStatusBarControl.MDIMergeStyle properties.

See the MDI Bar Merging and MDI Ribbon Merging topics to learn more.

See Also