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.v21.2.dll

NuGet Packages: DevExpress.Win.Design, 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
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

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.