Back to Devexpress

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

windowsforms-devexpress-dot-xtradiagram-dot-diagramcontrol-dot-printtopdf-x28-int32-orientationkind-pdfexportoptions-nullable-sizef-nullable-padding-boolean-x29.md

latest4.5 KB
Original Source

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

NuGet Package : DevExpress.Win.Diagram

Declaration

csharp
public void PrintToPdf(
    int pagesCount,
    OrientationKind fitOrientation,
    PdfExportOptions options = null,
    SizeF? pageSize = null,
    Padding? pageMargin = null,
    bool showOptionsDialog = true
)
vb
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

NameTypeDescription
pagesCountInt32

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

NameTypeDefaultDescription
optionsPdfExportOptionsnull

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).

See Also

DiagramControl Class

DiagramControl Members

DevExpress.XtraDiagram Namespace