How to: Merge Ribbon Controls

Nov 13, 2018
2 minutes to read

This example demonstrates the merging mechanism for RibbonControls in action. The main and child MDI forms contain RibbonControls. The child form's RibbonControl is merged into the main form's RibbonControl when the child form is maximized.

View Example

Form1.cs
Form1.vb

csharp

private void Form1_Load(object sender, EventArgs e) {
    // Enable the form's title bar transparency
    //this.AllowFormGlass = DevExpress.Utils.DefaultBoolean.False;
    // Specify that the merge mechanism should be invoked when a child MDI form is maximized.
    this.ribbonControl1.MdiMergeStyle = RibbonMdiMergeStyle.OnlyWhenMaximized;
    CreateChildForm();
}
private void btnNew_ItemClick(object sender, DevExpress.XtraBars.ItemClickEventArgs e) {
    CreateChildForm();
}
int ctr = 1;
void CreateChildForm() {
    // Create an MDI child form, containing a RibbonControl
    ReportForm child = new ReportForm();
    child.Text = "Report " + ctr.ToString();
    child.MdiParent = this;
    child.Show();
    ctr++;
}

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
    ' Enable the form's title bar transparency
    'this.AllowFormGlass = DevExpress.Utils.DefaultBoolean.False;
    ' Specify that the merge mechanism should be invoked when a child MDI form is maximized.
    Me.ribbonControl1.MdiMergeStyle = RibbonMdiMergeStyle.OnlyWhenMaximized
    CreateChildForm()
End Sub
Private Sub btnNew_ItemClick(ByVal sender As Object, ByVal e As DevExpress.XtraBars.ItemClickEventArgs) Handles btnNew.ItemClick
    CreateChildForm()
End Sub
Private ctr As Integer = 1
Private Sub CreateChildForm()
    ' Create an MDI child form, containing a RibbonControl
    Dim child As New ReportForm()
    child.Text = "Report " & ctr.ToString()
    child.MdiParent = Me
    child.Show()
    ctr += 1
End Sub