RibbonMergeType Enum

Specifies merging options used by the RibbonControl.Merge method.

Namespace: DevExpress.Xpf.Ribbon

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

Declaration

public enum RibbonMergeType
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:

Library Related API Members
WPF Controls RibbonPage.MergeType
RibbonPageCategoryBase.MergeType
RibbonPageGroup.MergeType
Silverlight Controls 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.

See Also