The requested page is not available for the requested platform. You are viewing the content for Default platform.

Add Items to the Report Designer's Ribbon Toolbar

This tutorial illustrates how to customize a Report Designer's ribbon toolbar by adding a new button to it.

Tip

See the following tutorial to learn how to add a Report Designer to a WinForms application: Create a Custom End-User Report Designer.

Do the following to customize the toolbar of a ribbon-based designer form:

  • Click the eud-ribbon-add-group-button button and add a new RibbonPageGroup to the toolbar.

    ribbon-report-designer-add-toolbar-group

  • Click the smart tag of the created page group and set its RibbonPageGroup.Text property to Help.

    eud-ribbon-rename-group

  • Click the eud-ribbon-add-button button in the created group and select Add Button in the invoked context menu.

    eud-ribbon-add-button-context-menu

  • Set the button's BarButtonItem.Caption property to About.
  • Handle the newly added button's BarItem.ItemClick event:

    private void barButtonItem1_ItemClick(object sender, DevExpress.XtraBars.ItemClickEventArgs e) {
        // Show the About dialog. 
        System.Windows.Forms.MessageBox.Show("This is a Ribbon Report Designer Form.", "About");
    }
    

The following image illustrates the result:

ribbon-report-designer-custom-button-result