XRDesignForm.OpenReport(XtraReport) Method

Loads the specified report instance to the XRDesignForm.

Namespace: DevExpress.XtraReports.UserDesigner

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

NuGet Package: DevExpress.Win.Reporting

Declaration

C#

public void OpenReport(
    XtraReport report
)

VB.NET

Public Sub OpenReport(
    report As XtraReport
)

Parameters

Name	Type	Description
report	XtraReport	An XtraReport object, or one of its descendants, representing the report to be opened.

Remarks

The OpenReport method opens a report in the currently active XRDesignPanel of the XRDesignForm. And, if there’s not yet a Design Panel available in the form, this method initializes an instance of the XRDesignPanel class and loads a report into it.

Example

This example shows how to override the SaveFile and OpenFile commands in the End-User Report Designer.

Form1.cs

using System;
using System.Windows.Forms;
using DevExpress.XtraReports.UserDesigner;

namespace CustomSavingEUD {
    public partial class Form1 : Form
    {
        public Form1() {
            InitializeComponent();
        }

        // Create an MDI (multi-document interface) controller instance.
        XRDesignMdiController mdiController;

        private void button1_Click(object sender, EventArgs e) {
            // Create a design form and get its MDI controller.
            XRDesignForm form = new XRDesignForm();
            mdiController = form.DesignMdiController;

            // Handle the DesignPanelLoaded event of the MDI controller,
            // to override the SaveCommandHandler for every loaded report.
            mdiController.DesignPanelLoaded +=
                new DesignerLoadedEventHandler(mdiController_DesignPanelLoaded);

            // Override the Open Command.
            mdiController.AddCommandHandler(new OpenCommandHandler());

            // Open an empty report in the form.
            mdiController.OpenReport(new XtraReport1());

            // Show the form.
            form.ShowDialog();
            if (mdiController.ActiveDesignPanel != null) {
                mdiController.ActiveDesignPanel.CloseReport();
            }
        }
        void mdiController_DesignPanelLoaded(object sender, DesignerLoadedEventArgs e) {
            XRDesignPanel panel = (XRDesignPanel)sender;
            // Override the Save Command.
            panel.AddCommandHandler(new SaveCommandHandler(panel));
        }
    }
}

Form1.vb

Imports System
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Linq
Imports System.Text
Imports System.Windows.Forms
Imports DevExpress.XtraReports.UserDesigner

Namespace CustomSavingEUD
    Partial Public Class Form1
        Inherits Form

        Public Sub New()
            InitializeComponent()
        End Sub

        ' Create an MDI (multi-document interface) controller instance.
        Private mdiController As XRDesignMdiController

        Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) Handles button1.Click
            ' Create a design form and get its MDI controller.
            Dim form As New XRDesignForm()
            mdiController = form.DesignMdiController

            ' Handle the DesignPanelLoaded event of the MDI controller,
            ' to override the SaveCommandHandler for every loaded report.
            AddHandler mdiController.DesignPanelLoaded, AddressOf mdiController_DesignPanelLoaded

            'Override the Open Command.
            mdiController.AddCommandHandler(New OpenCommandHandler())

            ' Open an empty report in the form.
            mdiController.OpenReport(New XtraReport1())

            ' Show the form.
            form.ShowDialog()
            If mdiController.ActiveDesignPanel IsNot Nothing Then
                mdiController.ActiveDesignPanel.CloseReport()
            End If
        End Sub
        Private Sub mdiController_DesignPanelLoaded(ByVal sender As Object, ByVal e As DesignerLoadedEventArgs)
            Dim panel As XRDesignPanel = DirectCast(sender, XRDesignPanel)
            panel.AddCommandHandler(New SaveCommandHandler(panel))
        End Sub
    End Class
End Namespace

The following code shows the Save and Open command handlers that implement the ICommandHandler interface:

SaveCommandHandler.cs

using DevExpress.XtraReports.UserDesigner;
public class SaveCommandHandler : ICommandHandler {
    XRDesignPanel panel;

    public SaveCommandHandler(XRDesignPanel panel) {
        this.panel = panel;
    }

    public void HandleCommand(ReportCommand command,
    object[] args) {
        // Save the report.
        Save();
    }

    public bool CanHandleCommand(ReportCommand command,
    ref bool useNextHandler) {
        useNextHandler = !(command == ReportCommand.SaveFile ||
            command == ReportCommand.SaveFileAs);
        return !useNextHandler;
    }

    void Save() {
        // Write your custom method here.
        // ...

        // Example:
        panel.Report.SaveLayout("report1.repx");

        // Prevent the "Report has been changed" dialog from being shown.
        panel.ReportState = ReportState.Saved;
    }
}

OpenCommandHandler.cs

using System.Windows.Forms;
using DevExpress.XtraReports.UserDesigner;

public class OpenCommandHandler : ICommandHandler {
    public OpenCommandHandler() {
    }

    public void HandleCommand(ReportCommand command,
    object[] args) {
        switch (command) {
            case ReportCommand.OpenFile:
                Open();
                break;
        }
    }

    public bool CanHandleCommand(ReportCommand command,
    ref bool useNextHandler) {
        useNextHandler = !(command == ReportCommand.OpenFile);
        return !useNextHandler;
    }

    void Open() {
        MessageBox.Show("Open");
    }
}

SaveCommandHandler.vb

Imports DevExpress.XtraReports.UserDesigner

Public Class SaveCommandHandler
    Implements ICommandHandler

    Private panel As XRDesignPanel

    Public Sub New(ByVal panel As XRDesignPanel)
        Me.panel = panel
    End Sub

    Public Sub HandleCommand(ByVal command As ReportCommand, ByVal args() As Object) Implements ICommandHandler.HandleCommand
        ' Save the report.
        Save()
    End Sub

    Public Function CanHandleCommand(ByVal command As ReportCommand, ByRef useNextHandler As Boolean) As Boolean Implements ICommandHandler.CanHandleCommand
        useNextHandler = Not (command = ReportCommand.SaveFile OrElse command = ReportCommand.SaveFileAs OrElse command = ReportCommand.Closing)
        Return Not useNextHandler
    End Function

    Private Sub Save()
        ' Write your custom method here.
        ' ...

        ' EXample:
        panel.Report.SaveLayout("report1.repx")

        ' Prevent the "Report has been changed" dialog from being shown.
        panel.ReportState = ReportState.Saved
    End Sub
End Class

OpenCommandHandler.vb

Imports DevExpress.XtraReports.UserDesigner

Public Class OpenCommandHandler
    Implements ICommandHandler

    Public Sub New()
    End Sub

    Public Sub HandleCommand(ByVal command As ReportCommand, ByVal args() As Object) Implements ICommandHandler.HandleCommand
        Select Case command
            Case ReportCommand.OpenFile
                Open()
        End Select
    End Sub

    Public Function CanHandleCommand(ByVal command As ReportCommand, ByRef useNextHandler As Boolean) As Boolean Implements ICommandHandler.CanHandleCommand
        useNextHandler = Not (command = ReportCommand.OpenFile)
        Return Not useNextHandler
    End Function

    Private Sub Open()
        MessageBox.Show("Open")
    End Sub
End Class

For information on how to customize the WinForms End-User Report Designer, review the following help topic: WinForms End-User Report Designer API and Customization.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the OpenReport(XtraReport) 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#

reporting-winforms-custom-progress-bar-control/CS/Form1.cs#L21

// Load a report into the Designer.
designForm.OpenReport(new XtraReport1());

reporting-crosstab-customization/CS/CrosstabControlCustomizationExample/Form1.cs#L36

    XtraReport report = (XtraReport)Activator.CreateInstance(Type.GetType(name));
    form.OpenReport(report);
}

VB.NET

reporting-winforms-custom-progress-bar-control/VB/Form1.vb#L22

' Load a report into the Designer.
designForm.OpenReport(New XtraReport1())

reporting-crosstab-customization/VB/CrossTabControlCustomizationExample/Form1.vb#L36

    Dim report As XtraReport = DirectCast(Activator.CreateInstance(Type.GetType(name_Renamed)), XtraReport)
    form.OpenReport(report)
End If

Implements

OpenReport(XtraReport)