PdfDocumentProcessor.Print(PdfPrinterSettings) Method

Prints the document with custom printer settings.

Namespace: DevExpress.Pdf

Assembly: DevExpress.Docs.v19.2.dll

Declaration

C#

public void Print(
    PdfPrinterSettings printerSettings
)

VB.NET

Public Sub Print(
    printerSettings As PdfPrinterSettings
)

Parameters

Name	Type	Description
printerSettings	PdfPrinterSettings	An object providing printer settings.

Remarks

Use the PdfPrinterSettings object to specify custom printer settings (orientation, scale, dpi, etc.). Use the PdfPrinterSettings.Settings property to access .NET print options.

Important

The Print method uses GDI/GDI+ rendering and works only on Windows OS. The PlatformNotSupportedException is thrown on other operating systems.

Example

This example shows how to print a document with custom printer settings.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-use-the-pdf-printer-settings-t172274

Program.cs

// Developer Express Code Central Example:
// How to use the PDF printer settings

using DevExpress.Pdf;

namespace PdfProcessorPrinterOptions
{
    class Program
    {

        static void Main(string[] args)
        {
            // Create a Pdf Document Processor instance and load a PDF into it.
            PdfDocumentProcessor documentProcessor = new PdfDocumentProcessor();
            documentProcessor.LoadDocument(@"..\..\Demo.pdf");

            // Declare the PDF printer settings.
            PdfPrinterSettings pdfPrinterSettings = new PdfPrinterSettings();

            // Specify the PDF printer settings.
            pdfPrinterSettings.PageOrientation = PdfPrintPageOrientation.Portrait;
            pdfPrinterSettings.PageNumbers = new int[] { 1, 3, 4, 5 };

            // Specify the custom scale number
            pdfPrinterSettings.ScaleMode = PdfPrintScaleMode.CustomScale;
            pdfPrinterSettings.Scale = 90;

            //Specify .NET printer settings
            PrinterSettings settings = printerSettings.Settings;
            settings.Duplex = Duplex.Vertical;
            settings.Copies = 3;


            // Print the document using the specified printer settings.
            documentProcessor.Print(pdfPrinterSettings);
        }
    }
}

Program.vb

' Developer Express Code Central Example:
' How to use the PDF printer settings

Imports DevExpress.Pdf

Namespace PdfProcessorPrinterOptions
    Friend Class Program

        Shared Sub Main(ByVal args() As String)
            ' Create a Pdf Document Processor instance and load a PDF into it.
            Dim documentProcessor As New PdfDocumentProcessor()
            documentProcessor.LoadDocument("..\..\Demo.pdf")

            ' Declare the PDF printer settings.
            Dim pdfPrinterSettings As New PdfPrinterSettings()

            ' Specify the PDF printer settings.
            pdfPrinterSettings.PageOrientation = PdfPrintPageOrientation.Portrait
            pdfPrinterSettings.PageNumbers = New Integer() { 1, 3, 4, 5 }

            ' Specify the custom scale number
            pdfPrinterSettings.ScaleMode = PdfPrintScaleMode.CustomScale
            pdfPrinterSettings.Scale = 90

            ' Specify .NET printer settings
            Dim settings As PrinterSettings = printerSettings.Settings
            settings.Duplex = Duplex.Vertical
            settings.Copies = 3

            ' Print the document using the specified printer settings.
            documentProcessor.Print(pdfPrinterSettings)
        End Sub
    End Class
End Namespace

Related GitHub Examples

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

pdf-document-api-customize-pdf-print-output/CS/CustomizePrintSettings/Program.cs#L25

// Print the document using the specified printer settings.
documentProcessor.Print(settings);

pdf-document-api-specify-printer-settings/CS/PdfProcessorPrinterOptions/Program.cs#L27

    // Print the document using the specified printer settings.
    documentProcessor.Print(pdfPrinterSettings);
}

VB.NET

pdf-document-api-customize-pdf-print-output/VB/CustomizePrintSettings/Program.vb#L21

' Print the document using the specified printer settings.
documentProcessor.Print(settings)
' Unsubscribe from PrintPage and QueryPageSettings events.

pdf-document-api-specify-printer-settings/VB/PdfProcessorPrinterOptions/Program.vb#L23

    ' Print the document using the specified printer settings.
    documentProcessor.Print(pdfPrinterSettings)
End Sub