Class VirtualPaperLayoutManager

Manages HtmlToPdf page layout behavior when rendering HTML to virtual PDF paper.

Provides options for Responsive CSS, Zoom, Fit-To-Page and Continuous feed printing options that are not available in standard Chrome.

Only one option may be selected at a time.

Inheritance
System.Object
VirtualPaperLayoutManager
Namespace: IronPdf.Engines.Chrome
Assembly: IronPdf.dll
Syntax
public class VirtualPaperLayoutManager : Object

Chrome engine in IronPDF is handled through VirtualPaperLayoutManager. It is part of the IronPDF Chrome engine API.

VirtualPaperLayoutManager matters when an application needs to configure or invoke Chrome engine from C# code. The class encapsulates the related options and behavior in a single object that is set up once and reused across render or processing calls. Typical scenarios include batch generation pipelines, templated document workflows, and integration with existing C# document services.

To use VirtualPaperLayoutManager, instantiate or obtain it from the relevant entry point in the IronPDF C# API. Key methods include UseChromeDefaultRendering, UseContinuousFeedRendering, UseFitToPageRendering, UseResponsiveCssRendering. Assign options or invoke methods on the instance to configure or perform the operation. The ironpdf 2021 chrome rendering engine eap covers typical usage in C# end to end.

using IronPdf;

// Obtain VirtualPaperLayoutManager from the relevant entry point in the IronPDF API
void Configure(VirtualPaperLayoutManager instance)
{
    instance.UseChromeDefaultRendering();
}

For the broader workflow, see the custom paper size guide in the IronPDF C# documentation. For broader context, the Chrome engine portion of the IronPDF C# API contains related types that work with VirtualPaperLayoutManager directly. VirtualPaperLayoutManager exposes additional members beyond those highlighted above; the reference tables on this page list the full set. In application code, treat VirtualPaperLayoutManager as a configured object that is constructed once and reused across operations rather than instantiated per call. Configuration is generally idempotent: assigning the same property value twice has the same effect as assigning it once. For diagnostic purposes, inspect the relevant VirtualPaperLayoutManager property after each operation to confirm the configured state. See the constructors, properties, and methods tables below for the complete API surface of VirtualPaperLayoutManager. Application code typically obtains or instantiates a single VirtualPaperLayoutManager and shares it across multiple IronPDF operations rather than recreating it per call.

The full declaration uses the VirtualPaperLayoutManager<T> generic form; docfx encodes generic arity as a numeric URL suffix, so the URL path reads VirtualPaperLayoutManager-1.html even though the class name itself is the bare form with type parameters.

Methods

UseChromeDefaultRendering()

Lays out PDF pages in the same way as when viewed from Google Chrome's print preview.

Responsive CSS viewport is interpreted based on the width of the Specified Paper Size. To change this responsive behavior use UseResponsiveCssRendering(Int32)

Declaration
public void UseChromeDefaultRendering()

UseContinuousFeedRendering(Double, Int32)

Creates a single page PDF which will force its entire content's width and height to fit into one page. Can be used for a consumer bill or receipt.

Declaration
public void UseContinuousFeedRendering(double width = 80, int margin = 5)
Parameters
Type Name Description
System.Double width

The width in millimeters to apply to the PDF page. Default is 80
System.Int32 margin

The margin in millimeters to apply to the PDF page. Default is 5

UseFitToPageRendering(Int32)

Scales content to fit the specified PaperSize. This mode measures minimum HTML content width after it is rendered by the browser, and then scales that content to fit to 1 sheet of paper wide where possible.

A minimum width can be set to control scaling and also to ensure that responsive CSS rules are correctly applied.

Declaration
public void UseFitToPageRendering(int MinimumPixelWidth = 1)
Parameters
Type Name Description
System.Int32 MinimumPixelWidth

A pixel based minimum width for the document. Can help HTML elements to display correctly and respond appropriately to CSS3 responsive layout rules.

UseResponsiveCssRendering(Int32)

Uses Responsive CSS to define the rendering of the HTML based on the ViewPortWidth parameter.

Content will attempt to scale the rendered content content to fill the width of the Specified Paper Size.

\

Set CssMediaType to choose between paper and screen CSS interpretations.

Declaration
public void UseResponsiveCssRendering(int ViewPortWidth = 1280)
Parameters
Type Name Description
System.Int32 ViewPortWidth

A pixel based virtual browser viewport for responsive CSS designs.

UseScaledRendering(Int32)

Adopts a layout which behaves in the same way the 'Chrome Print Preview' does for a given paper size, with an additional zoom level applied to allow content to be manually scaled by the developer.

Responsive CSS is interpreted based on the width of the Specified Paper Size

Declaration
public void UseScaledRendering(int ZoomPercentage = 100)
Parameters
Type Name Description
System.Int32 ZoomPercentage

A percentage based scale factor on the HTML document.

See Also