RibbonMergeType Enum

Specifies merging options used by the RibbonControl.Merge method.

Namespace: DevExpress.Xpf.Ribbon

Assembly: DevExpress.Xpf.Ribbon.v24.1.dll

NuGet Package: DevExpress.Wpf.Ribbon

Declaration

C#

public enum RibbonMergeType

VB.NET

Public Enum RibbonMergeType

Members

Name	Description
Add	Adds a child ribbon element to a parent ribbon even if an element with the same caption already exists in the parent ribbon.
Replace	Replaces a parent ribbon element with the current child ribbon element if they have the same caption. If a parent element with the same caption is not found, the current child ribbon element is added to the parent ribbon.
MergeItems	The default merging mechanism. Sub-items of the current child ribbon element are merged into the parent ribbon element that has the same caption. If no parent element with the same caption exists, the current child ribbon element is appended according to its MergeOrder.
Remove	Prevents the current child ribbon element from being merged with a parent ribbon object. If the MergeType for a parent element is set to Remove, this element is hidden after the merge is complete.

Related API Members

The following properties accept/return RibbonMergeType values:

• RibbonPage.MergeType
• RibbonPageCategoryBase.MergeType
• RibbonPageGroup.MergeType

Remarks

Depending on the RibbonMergeType enumeration value, the RibbonControl.Merge method can organize container items (page categories, pages and groups) in a single resulting item, duplicate or replace a parent RibbonControl item with a child one or remove both of them from the final RibbonControl. See the parameters above to learn about merging options.