Skip to main content
A newer version of this page is available. .
Bar

ToolBarMergeStyle Enum

Enumerates the types of controls for which automatic merging is enabled.

Namespace: DevExpress.Xpf.Bars

Assembly: DevExpress.Xpf.Core.v19.1.dll

Declaration

[Flags]
public enum ToolBarMergeStyle

Members

Name Description
None

Automatic merging is disabled.

MainMenu

Automatic merging is enabled for main menus and RibbonControls. Main menus are MainMenuControl and Bar controls with the Bar.IsMainMenu property set to true.

If the source and target main menus/Ribbon controls have different merge names (MergingProperties.Name), these objects will not be merged.

Merging is enabled if the source and target objects reside within the child and parent name scopes, respectively (see BarNameScope.IsScopeOwner).

StatusBar

Automatic merging is enabled for status bars. Status bars are StatusBarControl, RibbonStatusBarControl and Bar controls with the Bar.IsStatusBar property set to true.

If the source and target status bars have different merge names (MergingProperties.Name), these objects will not be merged.

Merging is enabled if the source and target objects reside within the child and parent name scopes, respectively (see BarNameScope.IsScopeOwner).

ToolBars

Automatic merging is enabled for regular bars. Regular bars are ToolBarControl and Bar controls with the Bar.IsMainMenu and Bar.IsStatusBar properties set to false.

A toolbar is merged to another toolbar that has the same Caption (ToolBarControlBase.Caption or Bar.Caption) or the same merge name (specified by the MergingProperties.Name attached property).

Merging is enabled if the source and target objects reside within the child and parent name scopes, respectively (see BarNameScope.IsScopeOwner).

MainMenuAndStatusBar

A combination of the ToolBarMergeStyle.MainMenu and ToolBarMergeStyle.StatusBar modes.

MainMenuAndToolBars

A combination of the ToolBarMergeStyle.MainMenu and ToolBarMergeStyle.ToolBars modes.

StatusBarAndToolBars

A combination of the ToolBarMergeStyle.StatusBar and ToolBarMergeStyle.ToolBars modes.

All

A combination of the ToolBarMergeStyle.MainMenu, ToolBarMergeStyle.StatusBar and ToolBarMergeStyle.ToolBars modes.

Remarks

Use the MergingProperties.ToolBarMergeStyle property to specify the types of controls for which automatic merging is enabled.

See Also