Bar

BarManager.MdiMenuMergeStyle Property

Gets or sets if and when a merge mechanism is invoked in an MDI application.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

[DefaultValue(BarMdiMenuMergeStyle.Always)]
[DXCategory("Behavior")]
public virtual BarMdiMenuMergeStyle MdiMenuMergeStyle { get; set; }
<DefaultValue(BarMdiMenuMergeStyle.Always)>
<DXCategory("Behavior")>
Public Overridable Property MdiMenuMergeStyle As BarMdiMenuMergeStyle

Property Value

Type Default Description
BarMdiMenuMergeStyle

Always

A BarMdiMenuMergeStyle value specifying when merge operations should be performed.

Remarks

For MDI applications, XtraBars provides merge functionality allowing you to combine the bars of parent and child MDI forms.

The MdiMenuMergeStyle property determines if and when merge and unmerge mechanisms are invoked. By default, the merge mechanism is invoked when a child MDI form is activated. Similarly, when the form becomes inactive, the unmerge mechanism is invoked.

XtraBars support automatic merging/unmerging of main menus. This means that if the parent and child MDI forms have main menus, they will be combined within the parent's main menu when the merge mechanism is invoked. The merge mechanism also fires the BarManager.Merge event when required and this allows you to merge other bars. To merge two bars belonging to different BarManagers, call the Bar.Merge method.

The unmerge mechanism invokes the BarManager.UnMerge event, which allows you to undo the results of the previous manual merge operation. Call the Bar.UnMerge method for this purpose.

The bar items' BarItem.MergeType properties determine how items are merged. This specifies whether the new items should be appended to the original items, replace them, etc. Refer to the MDI Merging document for more information.

See Also