Skip to main content
Bar

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

BarManager.MDIMergeStyle Property

Gets or sets if the BarManager’s bars can be merged.

Namespace: DevExpress.Xpf.Bars

Assembly: DevExpress.Xpf.Core.v24.2.dll

NuGet Package: DevExpress.Wpf.Core

#Declaration

public MDIMergeStyle MDIMergeStyle { get; set; }

#Property Value

Type Description
MDIMergeStyle

A MDIMergeStyle value specifying if the BarManager’s bars can be merged.

Available values:

Name Description
Default

Identical to the MDIMergeStyle.Always value.

WhenChildActivated

Bars/ribbons are merged in the following cases:

  • When you activate a maximized MDI child panel (MDI UI).
  • When you select a tab (tabbed UI).

Bars/ribbons are unmerged in the following cases:

  • When you restore a maximized MDI child panel from the maximized to the normal state or deactivate it (MDI UI).
  • When you deactivate a selected tab or select another tab (tabbed UI).
Always

The panel’s bar/ribbon is merged with the parent bar/ribbon in the following cases:

  • When you maximize a DocumentGroup‘s MDI child panel (MDI UI).
  • When you select the DocumentGroup‘s panel in the tab (tabbed UI).

If your layout contains multiple DocumentGroups, the merging mechanism is invoked for all DocumentGroups simultaneously. In this case, all of them are merged to the parent at the same time.

Bars/ribbons are unmerged in the following cases:

  • When you restore an MDI child panel from the maximized state to the normal state (MDI UI).
  • When you select another tab (Tabbed UI).
Never

Prevents all child tabbed and MDI panels from being merged.

WhenLoadedOrChildActivated

Similar to WhenChildActivated mode, but additionally merges MDI panels and tabs that are initially maximized (docked), but not yet selected (for example, on application start).

#Remarks

The merging mechanism is invoked according to the DockLayoutManager.MDIMergeStyle and DocumentPanel.MDIMergeStyle properties.

You can prevent bars that belong to the current BarManager from being merged by setting the BarManager.MDIMergeStyle property to MDIMergeStyle.Never. If the BarManager.MDIMergeStyle property is set to other values, the merging is enabled for the current BarManager.

See MDI Bar Merging to learn more.

See Also