Class PdfPrintMultiplePages

Configures N-up printing to place multiple PDF pages on a single physical sheet. Reduces paper usage by arranging pages in a grid layout (e.g., 2-up, 4-up, 6-up).

Example - Common configurations:

// 2-up printing (2 pages per sheet, side by side):
var twoUp = new PdfPrintMultiplePages(2, 1, PdfPaperOrientation.Landscape, 5f);
// 4-up printing (4 pages per sheet, 2x2 grid):
var fourUp = new PdfPrintMultiplePages(2, 2, PdfPaperOrientation.Portrait, 3f);
// 6-up printing (6 pages per sheet, 3x2 grid):
var sixUp = new PdfPrintMultiplePages(3, 2, PdfPaperOrientation.Landscape, 2f);
// Use with print settings:
var settings = new PdfPrintSettings(fourUp);
pdf.Print(settings);

Inheritance

System.Object

PdfPrintMultiplePages

Namespace: IronPdf.PrintDoc

Assembly: IronPdf.dll

Syntax

public class PdfPrintMultiplePages : Object

Remarks

Use landscape orientation for 2-up and 6-up layouts for better readability.

Related Resources:

Constructors

PdfPrintMultiplePages(Int32, Int32, PdfPaperOrientation, Single)

Creates a new N-up print configuration for arranging multiple pages per sheet.

Example:

// 4 pages per sheet in portrait:
var config = new PdfPrintMultiplePages(2, 2, PdfPaperOrientation.Portrait, 5f);

Declaration

public PdfPrintMultiplePages(int column, int row, PdfPaperOrientation orientation, float margin)

Parameters

Type	Name	Description
System.Int32	column	Number of pages horizontally (columns). Must be >= 1.
System.Int32	row	Number of pages vertically (rows). Must be >= 1.
PdfPaperOrientation	orientation	Physical page orientation for the output.
System.Single	margin	Space between pages in device units (default: 0). Must be >= 0.

Exceptions

Type	Condition
System.ArgumentOutOfRangeException	Column or row less than 1, or margin less than 0.

Properties

Column

Gets the number of pages to print horizontally.

Declaration

public int Column { get; }

Property Value

Type	Description
System.Int32

Margin

Gets the margin between PDF pages in device units.

Declaration

public float Margin { get; }

Property Value

Type	Description
System.Single

Orientation

Gets the orientation in which PDF pages are layed out on the physical page.

Declaration

public PdfPaperOrientation Orientation { get; }

Property Value

Type	Description
PdfPaperOrientation

Row

Gets the number of pages to print vertically.

Declaration

public int Row { get; }

Property Value

Type	Description
System.Int32

See Also

PdfPrintSettings