Skip to main content
Bar

BarItem.MergeType Property

Gets or sets the merge behavior for all links of the current BarItem.

Namespace: DevExpress.Xpf.Bars

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

NuGet Package: DevExpress.Wpf.Core

Declaration

public BarItemMergeType MergeType { get; set; }

Property Value

Type Description
BarItemMergeType

A BarItemMergeType enumeration value specifying the merge behavior.

Available values:

Name Description
Default

Acts identically to the Add value.

Add

Specifies that the child BarManager’s BarItemLink should be added to a bar/link container of a parent BarManager.

When merging bars and link containers, the position to insert the BarItemLink is determined by the BarItemLinkBase.MergeOrder properties of this link and of the links within the target bar/link container.

Replace

Indicates that the child BarManager’s BarItemLink should replace the parent BarManager’s link that has the same BarItem.Content, but only if the parent link’s BarItemLinkBase.MergeType property is also set to Replace.

If such a link is not found in the parent BarManager’s bar/link container, the child BarManager’s link will be added to the bar/link container (similar to the Add setting).

MergeItems

This setting is applied to link the following containers: Bar, BarSubItem, PopupMenu, BarLinkContainerItem.

When this setting is applied, the child container’s links are merged into the parent container with the same caption. If the captions of these containers are different, the child container’s links are added to the parent container (similar to the Add setting).

Remove

For a child BarManager’s BarItemLink, indicates that the link must not be added to the parent BarManager’s bar/link container during merging.

For a parent BarManager’s BarItemLink, indicates that the link must be removed from the bar/link container during merging.

Remarks

The MergeType property specifies how all links of the current BarItem behave during merge operations. This behavior can be overridden for particular links with the BarItemLinkBase.MergeType property. See BarItemLinkBase.MergeType for details.

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the MergeType 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.

See Also