Class DocxPdfRenderOptions

Margin values which can be copied from the main document to headers and footers applied to the document

Inheritance

System.Object

DocxPdfRenderOptions

Namespace: IronPdf

Assembly: IronPdf.dll

Syntax

public class DocxPdfRenderOptions : Object

Remarks

Common Configurations:

// Legal documents with specific margins:
var legalOptions = new DocxPdfRenderOptions {
 PaperSize = PdfPaperSize.Legal,
 MarginTop = 25.4,    // 1 inch
 MarginBottom = 25.4,
 MarginLeft = 25.4,
 MarginRight = 25.4,
 DPI = 300  // High quality for archival
};
// Presentation handouts:
var handoutOptions = new DocxPdfRenderOptions {
PaperSize = PdfPaperSize.A4,
PaperOrientation = PdfPaperOrientation.Landscape,
MarginTop = 15,
MarginBottom = 15,
GrayScale = true  // Save toner for printing
};
// eBook format:
var ebookOptions = new DocxPdfRenderOptions();
ebookOptions.SetCustomPaperSizeinMilimeters(120, 190);  // Kindle size
ebookOptions.MarginTop = 5;
ebookOptions.MarginBottom = 5;

Constructors

DocxPdfRenderOptions()

Default Constructor. Creates a new instance of DocxPdfRenderOptions with default settings.

Declaration

public DocxPdfRenderOptions()

Fields

PaperFit

Controls how HTML content is laid out on virtual PDF paper during Word document conversion. Provides advanced layout modes beyond standard print behavior.

Modes include: Default Chrome, Zoomed, Responsive CSS, Scale-to-Page, and Continuous Feed.

Example:

options.PaperFit.UseResponsiveCssRendering(1280);

Declaration

public readonly VirtualPaperLayoutManager1 PaperFit

Field Value

Type	Description
VirtualPaperLayoutManager1

See Also

VirtualPaperLayoutManager

Properties

FirstPageNumber

The starting page number for the PDF document. Use this to continue numbering from a previous document when splitting content.

Default: 1.

Example:

// Continue numbering from page 50:
options.FirstPageNumber = 50;

Declaration

public int FirstPageNumber { get; set; }

Property Value

Type	Description
System.Int32

ForcePaperSize

Force page sizes to be exactly what is specified via PaperSize by resizing the page after generating a PDF from HTML

Useful for bypassing CSS rules which specify paper size

Declaration

public bool ForcePaperSize { get; set; }

Property Value

Type	Description
System.Boolean

Remarks

Helps correct small errors in page size when rendering HTML to PDF

GrayScale

Outputs a black-and-white PDF

Default value is false.

Declaration

public bool GrayScale { get; set; }

Property Value

Type	Description
System.Boolean

InputEncoding

The input character encoding as a string;

Default value is Encoding.UTF8.

Declaration

public Encoding InputEncoding { get; set; }

Property Value

Type	Description
System.Text.Encoding

MailMergePrintAllInOnePdfDocument

This option enables the renderer to append all merged documents into one PdfDocument. To print separate PdfDocuments corresponding to each contact, this option should be set to false.

Declaration

public bool MailMergePrintAllInOnePdfDocument { get; set; }

Property Value

Type	Description
System.Boolean

MarginBottom

Bottom Pdf "paper" margin in millimeters. Set to zero for border-less and commercial printing applications.

Default value is 25.

Declaration

public double MarginBottom { get; set; }

Property Value

Type	Description
System.Double

MarginLeft

Left Pdf "paper" margin in millimeters. Set to zero for border-less and commercial printing applications.

Default value is 25.

Declaration

public double MarginLeft { get; set; }

Property Value

Type	Description
System.Double

MarginRight

Right Pdf "paper" margin in millimeters. Set to zero for border-less and commercial printing applications.

Default value is 25.

Declaration

public double MarginRight { get; set; }

Property Value

Type	Description
System.Double

MarginTop

Top Pdf "paper" margin in millimeters. Set to zero for border-less and commercial printing applications.

Default value is 25.

Declaration

public double MarginTop { get; set; }

Property Value

Type	Description
System.Double

PaperOrientation

The PDF paper orientation. E.g. Portrait or Landscape.

Default value is Portrait.

Declaration

public PdfPaperOrientation PaperOrientation { get; set; }

Property Value

Type	Description
PdfPaperOrientation

PaperSize

Set an output paper size for PDF pages. System.Drawing.Printing.PaperKind.

Use SetCustomPaperSize(int width, int height) for custom sizes.

Default value is A4.

Declaration

public PdfPaperSize PaperSize { get; set; }

Property Value

Type	Description
PdfPaperSize

PrintHtmlBackgrounds

Prints background-colors and images from Html.

Default value is true.

Declaration

public bool PrintHtmlBackgrounds { get; set; }

Property Value

Type	Description
System.Boolean

Timeout

Maximum time in seconds to wait for Word document conversion to complete. Increase for complex documents with many images or extensive formatting.

Default: 60 seconds.

Example:

// Allow 5 minutes for large documents:
options.Timeout = 300;

Declaration

public int Timeout { get; set; }

Property Value

Type	Description
System.Int32

WaitFor

A wrapper object that holds configuration for wait-for mechanism for user to wait for certain events before rendering.

Declaration

public WaitFor WaitFor { get; set; }

Property Value

Type	Description
WaitFor

Remarks

By default, it will wait for nothing.

Methods

SetCustomPaperSizeinCentimeters(Double, Double)

Set an output paper size for PDF pages. Dimensions are in Centimeters.

Declaration

public void SetCustomPaperSizeinCentimeters(double width, double height)

Parameters

Type	Name	Description
System.Double	width	Custom paper width in cm.
System.Double	height	Custom paper height in cm.

SetCustomPaperSizeInInches(Double, Double)

Set an output paper size for PDF pages. Dimensions are in Inches.

Declaration

public void SetCustomPaperSizeInInches(double width, double height)

Parameters

Type	Name	Description
System.Double	width	Custom paper width in Inches.
System.Double	height	Custom paper height in Inches.

SetCustomPaperSizeinMilimeters(Double, Double)

Set an output paper size for PDF pages. Dimensions are in millimeters.

Declaration

public void SetCustomPaperSizeinMilimeters(double width, double height)

Parameters

Type	Name	Description
System.Double	width	Custom paper width in millimeters.
System.Double	height	Custom paper height in millimeters.

SetCustomPaperSizeinPixelsOrPoints(Double, Double, Int32)

Set an output paper size for PDF pages. Dimensions are in screen Pixels or printer Points.

Declaration

public void SetCustomPaperSizeinPixelsOrPoints(double width, double height, int DPI = 96)

Parameters

Type	Name	Description
System.Double	width	Custom paper width in pixels/points.
System.Double	height	Custom paper height in pixels/points.
System.Int32	DPI	Intended print resolution of the PDF. To be clear PDFs have no fixed DPI/PPI value for rendering. 72 and 96 are common onscreen values. 300 is a comon value used in commercial printing.