BarItemMergeType Enum

Contains values that specify how item links behave during merge operations

Namespace: DevExpress.Xpf.Bars

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

Declaration

C#

public enum BarItemMergeType

VB.NET

Public Enum BarItemMergeType

Members

Name	Description
Default
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 simply be added to the bar/link container (similar to the Add setting).
MergeItems	This setting is applied to link containers (e.g. sub-menu). It specifies that subitems of the child BarManager's link container should be merged with subitems of a parent BarManager's link container. Merging occurs for the parent BarManager's link container, when the type and BarItem.Content match the source item, and only if its BarItemLinkBase.MergeType property is set to MergeItems. Otherwise, the child BarManager's link container will simply be added to the parent BarManager's bar (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.

Passed To

You can pass BarItemMergeType values to the following properies:

• BarItem.MergeType
• BarItemLinkBase.MergeType

Remarks

While merging, you can specify whether the bar item links of a child BarManager's bar/link container should be added to the parent BarManager's bar/link container (this is the default behavior), should replace item links on the parent bar with identical captions or should simply be removed from a bar. To specify these settings, use the BarItemLinkBase.MergeType properties of the child BarManager's links that need to be merged.

See MDI Bar Merging to learn more.