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

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

NuGet Package: DevExpress.Win.Navigation

Declaration

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

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

Corresponds to a Boolean value of true.

False

Corresponds to a Boolean value of false.

Default

The value is determined by the current object’s parent object setting (e.g., a control setting).

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.

childStatusBar.ItemLinks.Add(new BarStaticItem() { 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.

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.

See Also