Back to Devexpress

RibbonMergeType Enum

wpf-devexpress-dot-xpf-dot-ribbon-ff9319bc.md

latest2.6 KB
Original Source

RibbonMergeType Enum

Specifies merging options used by the RibbonControl.Merge method.

Namespace : DevExpress.Xpf.Ribbon

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

NuGet Package : DevExpress.Wpf.Ribbon

Declaration

csharp
public enum RibbonMergeType
vb
Public Enum RibbonMergeType

Members

NameDescription
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.

|

The following properties accept/return RibbonMergeType values:

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

Merge(RibbonControl)

DevExpress.Xpf.Ribbon Namespace