XRDesignRibbonForm Class

Namespace: DevExpress.XtraReports.UserDesigner

Assembly: DevExpress.XtraReports.v18.2.Extensions.dll

Declaration

public class XRDesignRibbonForm :
    RibbonForm,
    IDesignForm,
    IDisposable,
    ISupportLookAndFeel
Public Class XRDesignRibbonForm
    Inherits RibbonForm
    Implements IDesignForm,
               IDisposable,
               ISupportLookAndFeel

Remarks

Note

This feature is not available when using the .NET Framework's Client Profile subset. An end-user's machine needs to have the complete .NET Framework installed to enable this feature.

See the Application Deployment document for more information.

The XRDesignRibbonForm represents a Ribbon End-User Designer form with a multi-document interface.

It contains an XRDesignRibbonController, XRDesignMdiController and XRDesignDockManager components.

The following image demonstrates an Office-inspired Ribbon End-User Designer form.

To show the XRDesignRibbonForm, call its Show (ShowDialog) method, or the ReportDesignTool.ShowRibbonDesigner (ReportDesignTool.ShowRibbonDesignerDialog) method.

The currently active XRDesignPanel of the XRDesignMdiController can be accessed via the XRDesignRibbonForm.ActiveDesignPanel property.

See Report Designer to learn more.

Examples

When creating a custom Report Designer derived from the XRDesignRibbonForm class, you can load a report into it via the XRDesignRibbonForm.OpenReport method.

using DevExpress.XtraReports.UserDesigner;
// ...

private void Form1_Load(object sender, System.EventArgs e) {
    // Enables form skins in the application (if required).
    DevExpress.Skins.SkinManager.EnableFormSkins();
    DevExpress.LookAndFeel.LookAndFeelHelper.ForceDefaultLookAndFeelChanged();
}

private void button1_Click(object sender, System.EventArgs e) {
    // Create an End-User Report Designer form with a ribbon UI.
    XRDesignRibbonForm designForm = new XRDesignRibbonForm();

    // Create a new blank report.
    designForm.OpenReport(new XtraReport1());

    // Display the Report Designer form.
    //designForm.Show();

    // Display the Report Designer form, modally.
    designForm.ShowDialog();
}

Inheritance

Object
MarshalByRefObject
Component
Control
ScrollableControl
ContainerControl
Form
DevExpress.XtraEditors.DForm
DevExpress.XtraEditors.MouseWheelContainerForm
XtraForm
RibbonForm
XRDesignRibbonForm

Implements

DevExpress.XtraEditors.Drawing.IMouseWheelContainer
DevExpress.XtraEditors.IDXControl
DevExpress.XtraEditors.ICustomDrawNonClientArea
DevExpress.XtraEditors.IGlassForm
DevExpress.Utils.DPI.IDpiControl
DevExpress.Utils.Colors.ISupportDXSkinColors
DevExpress.XtraEditors.Drawing.ISupportGlassRegions
DevExpress.XtraBars.Controls.IBarObjectContainer
DevExpress.Utils.FormShadow.ISupportFormShadow
DevExpress.LookAndFeel.ISupportLookAndFeel
See Also