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.v23.2.Core.dll

NuGet Package: DevExpress.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.

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

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the PrintingSystem property.

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-export-options-actions/CS/ExportOptionSample/Form1.cs#L97

pdfExportOptions.DocumentOptions.Author = "VisualExportTool";
VisualExportTool.ExportFile(pdfExportOptions, printControl.PrintingSystem);
// You can add a log entry about the PDF export operation.

VB.NET

reporting-winforms-export-options-actions/VB/ExportOptionSample/Form1.vb#L99

pdfExportOptions.DocumentOptions.Author = "VisualExportTool"
VisualExportTool.ExportFile(pdfExportOptions, printControl.PrintingSystem)
' You can add a log entry about the PDF export operation.