PdfViewerControl.Print(PdfPrinterSettings, Boolean) Method

Prints a document using the specified PDF print settings without invoking the Print dialog.

Namespace: DevExpress.Xpf.PdfViewer

Assembly: DevExpress.Xpf.PdfViewer.v19.2.dll

Declaration

C#

public virtual void Print(
    PdfPrinterSettings printerSettings,
    bool showPrintStatus = true
)

VB.NET

Public Overridable Sub Print(
    printerSettings As PdfPrinterSettings,
    showPrintStatus As Boolean = True
)

Parameters

Name	Type	Description
printerSettings	PdfPrinterSettings	A PdfPrinterSettings value, specifying the PDF printing options.

Optional Parameters

Name	Type	Default	Description
showPrintStatus	Boolean	True	true, to show the printing status; otherwise, false.

Example

Note

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

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

C#

using System.Drawing.Printing;
using System.Windows;
using DevExpress.Pdf;

namespace SpecifyPrinterSettings {
    public partial class MainWindow : Window {
        public MainWindow() {
            InitializeComponent();

            // Load a PDF document.
            pdfViewer.OpenDocument(@"..\..\Demo.pdf");
        }

        private void pdfViewer_DocumentLoaded(object sender, RoutedEventArgs e) {
            // If required, declare and specify the system printer settings.
            PrinterSettings printerSettings = new PrinterSettings();
            printerSettings.PrinterName = "Microsoft XPS Document Writer";
            printerSettings.PrintToFile = true;
            printerSettings.PrintFileName = @"..\..\Demo.xps";

            // Declare the PDF printer settings.
            // If required, pass the system settings to the PDF printer settings constructor.
            PdfPrinterSettings pdfPrinterSettings = new PdfPrinterSettings(printerSettings);

            // Specify the PDF printer settings.
            pdfPrinterSettings.PageOrientation = PdfPrintPageOrientation.Auto;
            pdfPrinterSettings.PageNumbers = new int[] { 1, 3, 4, 5 };
            pdfPrinterSettings.ScaleMode = PdfPrintScaleMode.CustomScale;
            pdfPrinterSettings.Scale = 90;

            // Print the document using the specified printer settings and show print status parameter.            
            pdfViewer.Print(pdfPrinterSettings, true);
        }
    }
}

VB.NET

Imports System.Drawing.Printing
Imports System.Windows
Imports DevExpress.Pdf

Namespace SpecifyPrinterSettings
    Partial Public Class MainWindow
        Inherits Window

        Public Sub New()
            InitializeComponent()

            ' Load a PDF document.
            pdfViewer.OpenDocument("..\..\Demo.pdf")
        End Sub

        Private Sub pdfViewer_DocumentLoaded(ByVal sender As Object, ByVal e As RoutedEventArgs)
            ' If required, declare and specify the system printer settings.
            Dim printerSettings As New PrinterSettings()
            printerSettings.PrinterName = "Microsoft XPS Document Writer"
            printerSettings.PrintToFile = True
            printerSettings.PrintFileName = "..\..\Demo.xps"

            ' Declare the PDF printer settings.
            ' If required, pass the system settings to the PDF printer settings constructor.
            Dim pdfPrinterSettings As New PdfPrinterSettings(printerSettings)

            ' Specify the PDF printer settings.
            pdfPrinterSettings.PageOrientation = PdfPrintPageOrientation.Auto
            pdfPrinterSettings.PageNumbers = New Integer() { 1, 3, 4, 5 }
            pdfPrinterSettings.ScaleMode = PdfPrintScaleMode.CustomScale
            pdfPrinterSettings.Scale = 90

            ' Print the document using the specified printer settings and show print status parameter.            
            pdfViewer.Print(pdfPrinterSettings, True)
        End Sub
    End Class
End Namespace

XML

<Window
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:SpecifyPrinterSettings"
        xmlns:dxpdf="http://schemas.devexpress.com/winfx/2008/xaml/pdf" x:Class="SpecifyPrinterSettings.MainWindow"
        mc:Ignorable="d"
        Title="MainWindow" Height="350" Width="525">
    <Grid>

        <dxpdf:PdfViewerControl x:Name="pdfViewer" DocumentLoaded="pdfViewer_DocumentLoaded"/>

    </Grid>
</Window>