Back to Devexpress

BackstageItemBase.MergeType Property

wpf-devexpress-dot-xpf-dot-ribbon-dot-backstageitembase-4be68be0.md

latest3.3 KB
Original Source

BackstageItemBase.MergeType Property

Gets or sets how backstage controls should merge this item. This is a dependency property.

Namespace : DevExpress.Xpf.Ribbon

Assembly : DevExpress.Xpf.Ribbon.v25.2.dll

NuGet Package : DevExpress.Wpf.Ribbon

Declaration

csharp
public BarItemMergeType MergeType { get; set; }
vb
Public Property MergeType As BarItemMergeType

Property Value

TypeDescription
BarItemMergeType

A BarItemMergeType enumerator value that specifies how backstage controls should merge this item.

|

Available values:

NameDescription
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

See the “Links Merging Types” section of the MDI Bar Merging document to learn more.

See Also

Merge Bars and Ribbons in MDI Mode

BackstageItemBase Class

BackstageItemBase Members

DevExpress.Xpf.Ribbon Namespace