IPrintControl.PrintingSystem Property

Specifies the Printing System used to create and print a document for the link associated with the IPrintControl.

Namespace: DevExpress.XtraPrinting

Assembly: DevExpress.Printing.v20.2.Core.dll

NuGet Packages: DevExpress.Printing.Core, DevExpress.WindowsDesktop.Printing.Core

Declaration

C#

PrintingSystemBase PrintingSystem { get; }

VB.NET

ReadOnly Property PrintingSystem As PrintingSystemBase

Property Value

Type	Description
PrintingSystemBase	A PrintingSystemBase descendant.

Example

This example illustrates how to override Printing System commands in code.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/Reporting_how-to-override-commands-in-print-preview-custom-export-e2305

Form1.cs

using System;
using System.Windows.Forms;
using System.Drawing.Imaging;
using DevExpress.XtraPrinting;
using DevExpress.XtraReports.UI;
// ...
private void button1_Click(object sender, EventArgs e) {

    // Create a report instance, assigned to a Print Tool.
    ReportPrintTool pt = new ReportPrintTool(new XtraReport1());

    // Generate the report's document. This step is required
    // to activate its PrintingSystem and access it later.
    pt.Report.CreateDocument(false);

    // Override the ExportGraphic command.
    pt.PrintingSystem.AddCommandHandler(new ExportToImageCommandHandler());

    // Show the report's print preview.
    pt.ShowPreview();

}

public class ExportToImageCommandHandler : ICommandHandler {
    public virtual void HandleCommand(PrintingSystemCommand command,
    object[] args, IPrintControl printControl, ref bool handled) {
        if (!CanHandleCommand(command, printControl)) return;

        // Export the document to png.
        printControl.PrintingSystem.ExportToImage("C:\\Report.png", ImageFormat.Png);

        // Set handled to 'true' to prevent the standard exporting procedure from being called.
        handled = true;
    }

    public virtual bool CanHandleCommand(PrintingSystemCommand command, IPrintControl printControl) {
        // This handler is used for the ExportGraphic command.
        return command == PrintingSystemCommand.ExportGraphic;
    }
}

Form1.vb

Imports System
Imports System.Windows.Forms
Imports System.Drawing.Imaging
Imports DevExpress.XtraPrinting
Imports DevExpress.XtraReports.UI
' ...
Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) Handles button1.Click

    ' Create a report instance, assigned to a Print Tool.
    Dim pt As New ReportPrintTool(New XtraReport1())

    ' Generate the report's document. This step is required
    ' to activate its PrintingSystem and access it later.
    pt.Report.CreateDocument(False)

    ' Override the ExportGraphic command.
    pt.PrintingSystem.AddCommandHandler(New ExportToImageCommandHandler())

    ' Show the report's print preview.
    pt.ShowPreview()

End Sub

Public Class ExportToImageCommandHandler
    Implements ICommandHandler
            Public Overridable Sub HandleCommand(ByVal command As PrintingSystemCommand, _ 
            ByVal args() As Object, ByVal control As IPrintControl, _ 
            ByRef handled As Boolean) Implements ICommandHandler.HandleCommand
                If (Not CanHandleCommand(command, control)) Then
                    Return
                End If

                ' Export the document to png.
                control.PrintingSystem.ExportToImage("C:\Report.png", ImageFormat.Png)

                ' Set handled to 'true' to prevent the standard exporting procedure from being called.
                handled = True
            End Sub

            Public Overridable Function CanHandleCommand(ByVal command As PrintingSystemCommand, _ 
            ByVal control As IPrintControl) As Boolean Implements ICommandHandler.CanHandleCommand
                ' This handler is used for the ExportGraphic command.
                Return command = PrintingSystemCommand.ExportGraphic
            End Function
End Class