Skip to main content
All docs
V25.1
  • RibbonPageGroup.MergeType Property

    Specifies the active merge logic for this Ribbon Page Group: should the parent Ribbon copy items from a merged Page Group, ignore them, or use them to replace its own items.

    Namespace: DevExpress.XtraBars.Ribbon

    Assembly: DevExpress.XtraBars.v25.1.dll

    NuGet Package: DevExpress.Win.Navigation

    Declaration

    [DefaultValue(BarMenuMerge.MergeItems)]
    [DXCategory("Behavior")]
    [XtraSerializableProperty]
    public BarMenuMerge MergeType { get; set; }

    Property Value

    Type Default Description
    BarMenuMerge MergeItems

    Specifies the active merge logic for this Ribbon Page Group.

    Available values:

    Name Description
    Add

    Specifies that the child form’s bar item should be added to a bar/Ribbon Control or container item (e.g. menu) of a parent form.

    When merging bars and container items, the position to insert the item is determined by the BarItem.MergeOrder properties of this item and of the items within the target bar/container item.

    Replace

    Indicates that the child form’s bar item should replace the parent form’s item that has the same BarItem.Caption, but only if the parent item’s BarItem.MergeType property is also set to Replace.

    If such an item is not found in the parent form’s bar/RibbonControl, the child form’s item will simply be added to the bar/Ribbon Control (similar to the BarMenuMerge.Add setting).

    MergeItems

    This setting is applied to container items (BarCustomContainerItem descendants).

    It specifies that subitems of the child form’s container item should be merged with subitems of a parent form’s container item. Merging occurs for the parent form’s container item, whose type and BarItem.Caption match the source item’s ones and only if its BarItem.MergeType property is also set to MergeItems. Otherwise, the child form’s container item will simply be added to the parent form’s bar/Ribbon Control (similar to the BarMenuMerge.Add setting).

    Remove

    For a child form’s bar item, indicates that the item must not be added to the parent form’s bar/Ribbon Control during merging.

    For a parent form’s bar item, indicates that the item must be removed from the bar/Ribbon Control during merging.

    Remarks

    See this article for more information: Ribbon Merging.

    See Also