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

Add Items to a 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