Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Expand]Controls and Libraries
 [Expand]Common Features
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.DataAccess.UI.Design
  [Expand]DevExpress.DataAccess.UI.EntityFramework
  [Expand]DevExpress.DataAccess.UI.Excel
  [Expand]DevExpress.DataAccess.UI.Localization
  [Expand]DevExpress.DataAccess.UI.ObjectBinding
  [Expand]DevExpress.DataAccess.UI.Sql
  [Expand]DevExpress.DataAccess.UI.Wizard
  [Expand]DevExpress.DataAccess.UI.Wizard.Services
  [Expand]DevExpress.DataAccess.UI.Wizard.Views
  [Expand]DevExpress.DocumentView
  [Expand]DevExpress.DocumentView.Controls
  [Expand]DevExpress.LookAndFeel
  [Expand]DevExpress.LookAndFeel.Helpers
  [Expand]DevExpress.Skins
  [Expand]DevExpress.Snap
  [Expand]DevExpress.Snap.API.Native
  [Expand]DevExpress.Snap.Core
  [Expand]DevExpress.Snap.Core.API
  [Expand]DevExpress.Snap.Core.Fields
  [Expand]DevExpress.Snap.Core.Forms
  [Expand]DevExpress.Snap.Core.Options
  [Expand]DevExpress.Snap.Core.Services
  [Expand]DevExpress.Snap.Extensions
  [Expand]DevExpress.Snap.Extensions.Localization
  [Expand]DevExpress.Snap.Extensions.UI
  [Expand]DevExpress.Snap.Localization
  [Expand]DevExpress.Snap.Options
  [Expand]DevExpress.Snap.Services
  [Expand]DevExpress.Utils
  [Expand]DevExpress.Utils.Animation
  [Expand]DevExpress.Utils.Controls
  [Expand]DevExpress.Utils.Drawing
  [Expand]DevExpress.Utils.Menu
  [Expand]DevExpress.Utils.Taskbar
  [Expand]DevExpress.Utils.Taskbar.Core
  [Expand]DevExpress.Utils.UI.Localization
  [Expand]DevExpress.Utils.VisualEffects
  [Expand]DevExpress.Utils.Win
  [Expand]DevExpress.XtraBars
  [Expand]DevExpress.XtraBars.Alerter
  [Expand]DevExpress.XtraBars.Docking
  [Expand]DevExpress.XtraBars.Docking2010
  [Expand]DevExpress.XtraBars.Docking2010.Customization
  [Expand]DevExpress.XtraBars.Docking2010.Views
  [Expand]DevExpress.XtraBars.Docking2010.Views.NativeMdi
  [Expand]DevExpress.XtraBars.Docking2010.Views.Tabbed
  [Expand]DevExpress.XtraBars.Docking2010.Views.Widget
  [Expand]DevExpress.XtraBars.Docking2010.Views.WindowsUI
  [Expand]DevExpress.XtraBars.Localization
  [Expand]DevExpress.XtraBars.Navigation
  [Collapse]DevExpress.XtraBars.Ribbon
   [Expand]ApplicationMenu Class
   [Expand]AppMenuFileLabel Class
   [Expand]BackstageViewButtonItem Class
   [Expand]BackstageViewClientControl Class
   [Expand]BackstageViewControl Class
   [Expand]BackstageViewControlItemCollecton Class
   [Expand]BackstageViewItem Class
   [Expand]BackstageViewItemBase Class
   [Expand]BackstageViewItemEventArgs Class
    BackstageViewItemEventHandler Delegate
   [Expand]BackstageViewItemSeparator Class
    BackstageViewShowRibbonItems Enumeration
   [Expand]BackstageViewTabItem Class
   [Expand]GalleryControl Class
   [Expand]GalleryDropDown Class
   [Expand]GalleryFilterMenuClickEventArgs Class
   [Expand]GalleryFilterMenuEventArgs Class
   [Expand]GalleryItem Class
   [Expand]GalleryItemClickEventArgs Class
    GalleryItemClickEventHandler Delegate
   [Expand]GalleryItemCollection Class
   [Expand]GalleryItemCustomDrawEventArgs Class
    GalleryItemCustomDrawEventHandler Delegate
   [Expand]GalleryItemEventArgs Class
   [Expand]GalleryItemGroup Class
    GalleryItemGroupCaptionAlignment Enumeration
   [Expand]GalleryItemGroupCollection Class
    GallerySizeMode Enumeration
   [Expand]ImageGalleryFilterMenu Class
    ItemImageLocation Enumeration
   [Expand]RadialMenu Class
   [Expand]RecentButtonItem Class
   [Expand]RecentControlContainerItem Class
   [Expand]RecentHyperlinkItem Class
   [Expand]RecentItemBase Class
   [Expand]RecentItemControl Class
   [Expand]RecentItemEventArgs Class
   [Expand]RecentLabelItem Class
   [Expand]RecentPanelBase Class
   [Expand]RecentPinItem Class
   [Expand]RecentSeparatorItem Class
   [Expand]RecentStackPanel Class
   [Expand]RecentTabItem Class
   [Expand]RecentTextGlyphItemBase Class
   [Expand]RibbonBarItems Class
   [Expand]RibbonControl Class
    RibbonControlColorScheme Enumeration
    RibbonControlStyle Enumeration
   [Expand]RibbonForm Class
    RibbonItemStyles Enumeration
    RibbonMdiMergeStyle Enumeration
   [Expand]RibbonMiniToolbar Class
   [Expand]RibbonMiniToolbarCollection Class
   [Expand]RibbonMiniToolbarOpacityOptions Class
   [Expand]RibbonOptionsTouch Class
   [Expand]RibbonPage Class
   [Expand]RibbonPageCategory Class
    RibbonPageCategoryAlignment Enumeration
   [Expand]RibbonPageCategoryCollection Class
   [Expand]RibbonPageCollection Class
   [Expand]RibbonPageGroup Class
   [Expand]RibbonPageGroupCollection Class
   [Expand]RibbonPageGroupEventArgs Class
    RibbonPageGroupEventHandler Delegate
    RibbonPageGroupItemsLayout Enumeration
   [Expand]RibbonQuickAccessToolbar Class
    RibbonQuickAccessToolbarLocation Enumeration
   [Collapse]RibbonStatusBar Class
     RibbonStatusBar Members
    [Expand]RibbonStatusBar Constructor
    [Expand]RibbonStatusBar Properties
    [Expand]RibbonStatusBar Events
    [Collapse]RibbonStatusBar Methods
      AccessibleNotifyClients Method
      CalcHitInfo Method
      LayoutChanged Method
      MergeStatusBar Method
      Refresh Method
      UnMergeStatusBar Method
    ShowPageHeadersMode Enumeration
  [Expand]DevExpress.XtraBars.Ribbon.Gallery
  [Expand]DevExpress.XtraBars.Ribbon.ViewInfo
  [Expand]DevExpress.XtraBars.ToastNotifications
  [Expand]DevExpress.XtraBars.Utils
  [Expand]DevExpress.XtraBars.WinRTLiveTiles
  [Expand]DevExpress.XtraCharts
  [Expand]DevExpress.XtraCharts.Designer
  [Expand]DevExpress.XtraCharts.Wizard
  [Expand]DevExpress.XtraDataLayout
  [Expand]DevExpress.XtraDiagram
  [Expand]DevExpress.XtraDiagram.Options
  [Expand]DevExpress.XtraEditors
  [Expand]DevExpress.XtraEditors.ButtonPanel
  [Expand]DevExpress.XtraEditors.Calendar
  [Expand]DevExpress.XtraEditors.Camera
  [Expand]DevExpress.XtraEditors.Container
  [Expand]DevExpress.XtraEditors.Controls
  [Expand]DevExpress.XtraEditors.CustomEditor
  [Expand]DevExpress.XtraEditors.DXErrorProvider
  [Expand]DevExpress.XtraEditors.Filtering
  [Expand]DevExpress.XtraEditors.Mask
  [Expand]DevExpress.XtraEditors.Persistent
  [Expand]DevExpress.XtraEditors.Repository
  [Expand]DevExpress.XtraEditors.ViewInfo
  [Expand]DevExpress.XtraFilterEditor
  [Expand]DevExpress.XtraGauges.Presets.Styles
  [Expand]DevExpress.XtraGauges.Win
  [Expand]DevExpress.XtraGauges.Win.Base
  [Expand]DevExpress.XtraGauges.Win.Gauges.Circular
  [Expand]DevExpress.XtraGauges.Win.Gauges.Digital
  [Expand]DevExpress.XtraGauges.Win.Gauges.Linear
  [Expand]DevExpress.XtraGauges.Win.Gauges.State
  [Expand]DevExpress.XtraGrid
  [Expand]DevExpress.XtraGrid.Columns
  [Expand]DevExpress.XtraGrid.EditForm
  [Expand]DevExpress.XtraGrid.FilterEditor
  [Expand]DevExpress.XtraGrid.Localization
  [Expand]DevExpress.XtraGrid.Views.BandedGrid
  [Expand]DevExpress.XtraGrid.Views.BandedGrid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Base
  [Expand]DevExpress.XtraGrid.Views.Base.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Card
  [Expand]DevExpress.XtraGrid.Views.Card.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Grid
  [Expand]DevExpress.XtraGrid.Views.Grid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Layout
  [Expand]DevExpress.XtraGrid.Views.Layout.Events
  [Expand]DevExpress.XtraGrid.Views.Layout.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Printing
  [Expand]DevExpress.XtraGrid.Views.Tile
  [Expand]DevExpress.XtraGrid.Views.WinExplorer
  [Expand]DevExpress.XtraGrid.WinExplorer
  [Expand]DevExpress.XtraLayout
  [Expand]DevExpress.XtraLayout.Customization
  [Expand]DevExpress.XtraLayout.HitInfo
  [Expand]DevExpress.XtraLayout.Localization
  [Expand]DevExpress.XtraLayout.Utils
  [Expand]DevExpress.XtraMap
  [Expand]DevExpress.XtraMap.Printing
  [Expand]DevExpress.XtraNavBar
  [Expand]DevExpress.XtraNavBar.ViewInfo
  [Expand]DevExpress.XtraPdfViewer
  [Expand]DevExpress.XtraPdfViewer.Commands
  [Expand]DevExpress.XtraPdfViewer.Localization
  [Expand]DevExpress.XtraPivotGrid
  [Expand]DevExpress.XtraPivotGrid.Data
  [Expand]DevExpress.XtraPrinting
  [Expand]DevExpress.XtraPrinting.Control
  [Expand]DevExpress.XtraPrinting.Preview
  [Expand]DevExpress.XtraPrintingLinks
  [Expand]DevExpress.XtraReports.UI
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Commands
  [Expand]DevExpress.XtraRichEdit.Export
  [Expand]DevExpress.XtraRichEdit.Import
  [Expand]DevExpress.XtraRichEdit.Localization
  [Expand]DevExpress.XtraRichEdit.Menu
  [Expand]DevExpress.XtraScheduler
  [Expand]DevExpress.XtraScheduler.Drawing
  [Expand]DevExpress.XtraScheduler.Printing
  [Expand]DevExpress.XtraScheduler.Reporting
  [Expand]DevExpress.XtraScheduler.Reporting.UI
  [Expand]DevExpress.XtraScheduler.Services
  [Expand]DevExpress.XtraScheduler.Services.Implementation
  [Expand]DevExpress.XtraScheduler.UI
  [Expand]DevExpress.XtraSpellChecker
  [Expand]DevExpress.XtraSpellChecker.Localization
  [Expand]DevExpress.XtraSplashForm
  [Expand]DevExpress.XtraSplashScreen
  [Expand]DevExpress.XtraSpreadsheet
  [Expand]DevExpress.XtraSpreadsheet.Services
  [Expand]DevExpress.XtraTab
  [Expand]DevExpress.XtraTab.Buttons
  [Expand]DevExpress.XtraTab.ViewInfo
  [Expand]DevExpress.XtraTabbedMdi
  [Expand]DevExpress.XtraToolbox
  [Expand]DevExpress.XtraTreeList
  [Expand]DevExpress.XtraTreeList.Columns
  [Expand]DevExpress.XtraTreeList.Data
  [Expand]DevExpress.XtraTreeList.Localization
  [Expand]DevExpress.XtraTreeList.Menu
  [Expand]DevExpress.XtraTreeList.Nodes
  [Expand]DevExpress.XtraTreeList.Nodes.Operations
  [Expand]DevExpress.XtraTreeList.StyleFormatConditions
  [Expand]DevExpress.XtraTreeMap
  [Expand]DevExpress.XtraVerticalGrid
  [Expand]DevExpress.XtraVerticalGrid.Events
  [Expand]DevExpress.XtraVerticalGrid.Localization
  [Expand]DevExpress.XtraVerticalGrid.Rows
  [Expand]DevExpress.XtraWaitForm
  [Expand]DevExpress.XtraWizard
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

RibbonStatusBar.MergeStatusBar Method

Merges the specified RibbonStatusBar object into the current RibbonStatusBar object.

Namespace:DevExpress.XtraBars.Ribbon
Assembly:DevExpress.XtraBars.v17.2.dll

Expanded Syntax

Parameters

mergedStatusBar
Type: RibbonStatusBar
A RibbonStatusBar object to be merged into the current status bar.

Expanded Remarks

During merging, a RibbonControl of a child MDI form is automatically merged with a Ribbon Control within the parent MDI form. RibbonStatusBar objects of the child and parent MDI forms are not merged automatically. To merge them immediately after the Ribbon Controls have been merged, call the MergeStatusBar method within your RibbonControl.Merge event handler. The Merge event fires after another RibbonStatusBar object has been merged with the current RibbonStatusBar object.

If RibbonStatusBar objects have been manually merged, they must be manually unmerged via the UnMergeStatusBar method. To unmerge status bars when the default unmerge mechanism is invoked, call the UnMergeStatusBar method within your RibbonControl.UnMerge event handler.

The BarItem.MergeType properties of bar items in a main and child MDI forms define how the items behave during merge operations: whether the child form's items replace the main form's items, or are simply appended to the parent form's Ribbon Control/status bar, etc.

See Ribbon Merging to learn more.

Expanded Example

The following example shows how to merge RibbonStatusBar objects in an MDI application, when the Ribbon merging mechanism is invoked. It's assumed that both the parent and child MDI forms contain RibbonStatusBar objects. To merge them, the MergeStatusBar method is called in a RibbonControl.Merge event handler. To unmerge the status bars, the UnMerge method is called in a RibbonControl.UnMerge event handler.

Expanded See Also

How would you rate this topic?​​​​​​​