DiagramControl.PrintToPdf(Int32, OrientationKind, PdfExportOptions, Nullable<SizeF>, Nullable<Padding>, Boolean) Method

Exports the diagram to a multi-page PDF file specified by the user in the invoked dialog window.

Namespace: DevExpress.XtraDiagram

Assembly: DevExpress.XtraDiagram.v25.1.dll

NuGet Package: DevExpress.Win.Diagram

Declaration

C#

public void PrintToPdf(
    int pagesCount,
    OrientationKind fitOrientation,
    PdfExportOptions options = null,
    SizeF? pageSize = null,
    Padding? pageMargin = null,
    bool showOptionsDialog = true
)

VB.NET

Public Sub PrintToPdf(
    pagesCount As Integer,
    fitOrientation As OrientationKind,
    options As PdfExportOptions = Nothing,
    pageSize As SizeF? = Nothing,
    pageMargin As Padding? = Nothing,
    showOptionsDialog As Boolean = True
)

Parameters

Name	Type	Description
pagesCount	Int32	An integer value that specifies the number of pages to which to fit the diagram.
fitOrientation	OrientationKind	A System.Windows.Controls.Orientation enumeration value.

Optional Parameters

Name	Type	Default	Description
options	PdfExportOptions	null	The options that define how a document is exported.
pageSize	Nullable<SizeF>	null	A System.Drawing.SizeF object specifying the PDF page size.
pageMargin	Nullable<Padding>	null	A System.Windows.Forms.Padding object specifying the PDF page margins.
showOptionsDialog	Boolean	True	true, to invoke the dialog window which allows the user to change export options; otherwise, false.

Remarks

If a method parameter is not specified, the corresponding DiagramOptionsView or DiagramOptionsExport property value is used. See the table below.

Method Parameter	DiagramControl Property
options	PdfExportOptions
printBounds	PrintExportMode, PageMargin
pageSize	PageSize
pageMargin	PageMargin

Use the ExportToPdf method to export the diagram to a single-page PDF document.

Note

The printing mechanism relies on both pagesCount and fitOrientation parameters in diagram size calculations. If the fitOrientation parameter is Horizontal, the printing mechanism fits the diagram to the specified number of pages horizontally. It uses any number of pages vertically to fit the diagram (and vice versa).