Bar.AutoUpdateMergedBars Property

Gets or sets whether items added to/removed from a child bar merged with this bar are automatically added to/removed from this bar.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Behavior")]
public DefaultBoolean AutoUpdateMergedBars { get; set; }

VB.NET

<DefaultValue(DefaultBoolean.Default)>
<DXCategory("Behavior")>
Public Property AutoUpdateMergedBars As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	True if items added to/removed from a child bar merged with this bar are automatically added to/removed from this bar; otherwise, Default or False.

Available values:

Name	Description	Return Value
True	The value is true.	0
False	The value is false.	1
Default	The value is specified by a global option or a higher-level object.	2

Example

This example shows how to automatically update a parent status bar that is merged with a child status bar.

For example, a child status bar displays a page number. Then a new message that displays a number of words is added to the child status bar.

C#

childStatusBar.ItemLinks.Add(new BarStaticItem() { Caption = "750 WORDS" });

VB.NET

childStatusBar.ItemLinks.Add(New BarStaticItem() With {.Caption = "750 WORDS"})

If the child status bars is merged with the parent status bar, the new message is not automatically added to the parent status bar when you add it to the child status bar. To update the parent status bar automatically, set its AutoUpdateMergedBars property to True.

C#

parentStatusBar.AutoUpdateMergedBars = DevExpress.Utils.DefaultBoolean.True;

VB.NET

parentStatusBar.AutoUpdateMergedBars = DevExpress.Utils.DefaultBoolean.True

As a result, the new message is automatically added to the parent status bar, when it is added to the child status bar.

Note

When a child form is maximized, ribbons and bars are merged automatically while status bars should be merged manually. See How to: Merge RibbonStatusBar Objects.