RibbonStatusBar.UnMergeStatusBar() Method

Restores the bar commands layout within the current RibbonStatusBar object after another RibbonStatusBar object has been merged into it.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v19.2.dll

Declaration

C#

public virtual void UnMergeStatusBar()

VB.NET

Public Overridable Sub UnMergeStatusBar

Remarks

RibbonStatusBar objects can be merged via the RibbonStatusBar.MergeStatusBar method. The UnMergeStatusBar method allows the status bars to be unmerged. This method restores the original layout of bar commands within the current RibbonStatusBar object. To unmerge RibbonStatusBar objects when the standard unmerge mechnism is invoked, handle the RibbonControl.UnMerge event.

After RibbonStatusBar objects have been unmerged, the RibbonStatusBar.UnMerge event fires.

See Ribbon Merging to learn more.

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 RibbonStatusBar.MergeStatusBar method is called in a RibbonControl.Merge event handler. To unmerge the status bars, the RibbonStatusBar.UnMerge method is called in a RibbonControl.UnMerge event handler.

C#

using DevExpress.XtraBars.Ribbon;

// Merge Ribbon Controls when a child form is maximized
RibbonControl1.MdiMergeStyle = DevExpress.XtraBars.Ribbon.RibbonMdiMergeStyle.OnlyWhenMaximized;

// Manually merge the status bars of the parent and child MDI forms.
private void RibbonControl1_Merge(object sender, RibbonMergeEventArgs e) {
    RibbonControl parentRRibbon = sender as RibbonControl;
    RibbonControl childRibbon = e.MergedChild;
    parentRRibbon.StatusBar.MergeStatusBar(childRibbon.StatusBar);
}
// Manually unmerge the status bars.
private void RibbonControl1_UnMerge(object sender, RibbonMergeEventArgs e) {
    RibbonControl parentRRibbon = sender as RibbonControl;            
    parentRRibbon.StatusBar.UnMergeStatusBar();
}

VB.NET

Imports DevExpress.XtraBars.Ribbon

' Merge Ribbon Controls when a child form is maximized
Private RibbonControl1.MdiMergeStyle = _ 
DevExpress.XtraBars.Ribbon.RibbonMdiMergeStyle.OnlyWhenMaximized

' Manually merge the status bars of the parent and child MDI forms.
Private Sub RibbonControl1_Merge(ByVal sender As System.Object, _
ByVal e As RibbonMergeEventArgs) Handles RibbonControl1.Merge
    Dim parentRRibbon As RibbonControl = TryCast(sender, RibbonControl)
    Dim childRibbon As RibbonControl = e.MergedChild
    parentRRibbon.StatusBar.MergeStatusBar(childRibbon.StatusBar)
End Sub

' Manually unmerge the status bars.
Private Sub RibbonControl1_UnMerge(ByVal sender As System.Object, _
ByVal e As RibbonMergeEventArgs) Handles RibbonControl1.UnMerge
    Dim parentRRibbon As RibbonControl = TryCast(sender, RibbonControl)
    parentRRibbon.StatusBar.UnMergeStatusBar()
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the UnMergeStatusBar() method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

lesson-5-complex-navigation-in-mvpvm-application-t136053/CS/MvpvmNavigation/Presenter/MainFormPresenter.cs#L33

    if (mainForm.Ribbon.StatusBar != null)
        mainForm.Ribbon.StatusBar.UnMergeStatusBar();
}

lesson-6-multi-level-navigation-in-mvpvm-applications-t146514/CS/MvpvmNavigation/Presenter/MainFormPresenter.cs#L33

    if (mainForm.Ribbon.StatusBar != null)
        mainForm.Ribbon.StatusBar.UnMergeStatusBar();
}

VB.NET

lesson-5-complex-navigation-in-mvpvm-application-t136053/VB/MvpvmNavigation/Presenter/MainFormPresenter.vb#L37

If mainForm.Ribbon.StatusBar IsNot Nothing Then
    mainForm.Ribbon.StatusBar.UnMergeStatusBar()
End If

lesson-6-multi-level-navigation-in-mvpvm-applications-t146514/VB/MvpvmNavigation/Presenter/MainFormPresenter.vb#L37

If mainForm.Ribbon.StatusBar IsNot Nothing Then
    mainForm.Ribbon.StatusBar.UnMergeStatusBar()
End If