windowsforms-devexpress-dot-xtrabars-dot-bar-ad11138c.md
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.v25.2.dll
NuGet Package : DevExpress.Win.Navigation
[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Behavior")]
public DefaultBoolean AutoUpdateMergedBars { get; set; }
<DefaultValue(DefaultBoolean.Default)>
<DXCategory("Behavior")>
Public Property AutoUpdateMergedBars As DefaultBoolean
| 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
|
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" });
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.
parentStatusBar.AutoUpdateMergedBars = DevExpress.Utils.DefaultBoolean.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