Cómo renderizar PDFs con tamaño de papel personalizado en C#

¿Qué tamaños de papel estándar hay disponibles?

A continuación se muestra un ejemplo de cómo establecer un tamaño de papel estándar:

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size.cs

using IronPdf;
using IronPdf.Rendering;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>");

pdf.SaveAs("standardPaperSize.pdf");

IronPDF admite una amplia colección de tamaños de papel estándar, entre los que se incluyen:

• Serie ISO 216: A0 a A10, B0 a B10
• Norteamericano: Carta, Legal, Tabloide, Ejecutivo
• Arquitectura: ANSI A a E
• Japonés: JIS B0 a B10
• Tamaños de los sobres: Varios estándares internacionales de sobres

Para obtener una lista completa de los tamaños de papel disponibles y sus dimensiones, consulte la documentación de referencia de la API.

¿Qué propiedades controlan el tamaño del papel?

• PaperSize: establece un tamaño de papel de salida para páginas PDF con tamaños predefinidos como carta, A3, A4, etc.
• ForzarTamañoDePágina: Obliga a que el tamaño de página sea exactamente el especificado mediante IronPdf.ChromePdfRenderOptions.PaperSize al cambiar el tamaño de la página después de generar un PDF a partir de HTML. Esta función es útil para evitar las reglas CSS que especifican el tamaño del papel.

Al utilizar estas propiedades junto con margenes personalizados, puede lograr un control preciso sobre el diseño de su PDF.

¿Cómo obtener tamaños de papel estándar en diferentes unidades?

¿Necesitas encontrar las dimensiones de tamaños de papel estándar? Puedes hacerlo fácilmente utilizando el método ToMillimeters. Este método devuelve una tupla que contiene la anchura y la altura del tamaño de papel estándar como objetos Length. La clase Length es increíblemente versátil, lo que le permite convertir sin esfuerzo estas dimensiones en una variedad de unidades, incluyendo:

• Milímetros
• Centímetros
• Pulgadas
• Píxeles
• Puntos

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-standard-paper-size-in-other-unit.cs

using IronPdf.Rendering;

double A4WidthInPixel = PdfPaperSize.A4.ToMillimeters().width.ToPixel();
double A4HeightInCentimeter = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter();

Esta funcionalidad es especialmente útil cuando se integra con Diseños responsivos CSS o cuando se necesita calcular las dimensiones exactas para diseños personalizados.

¿Qué unidades puedo utilizar para las dimensiones personalizadas?

Ejemplo de cómo establecer un tamaño de papel personalizado en cm:

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-cm.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15);

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>");

pdf.SaveAs("customPaperSize.pdf");

A continuación se ofrecen ejemplos adicionales para cada unidad de medida:

// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);

// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size

// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI

// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);

// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size

// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI

Al trabajar con tamaños personalizados, es posible que también desee explorar configuraciones de vista y zoom para asegurarse de que su contenido se ajusta correctamente a las dimensiones personalizadas.

¿Qué parámetros acepta ExtendPage?

El método ExtendPage acepta los siguientes parámetros:

• Índice de página: El índice de base cero de la página a modificar
• Extensión izquierda: Importe para ampliar/reducir el lado izquierdo
• Extensión derecha: Importe para ampliar/reducir el lado derecho
• Extensión superior: Importe para ampliar/reducir la parte superior
• Extensión inferior: Cantidad para extender/reducir la parte inferior
• Unidad de medida: La unidad de medida (milímetros, pulgadas, etc.)

A continuación se muestra un ejemplo de cómo modificar las dimensiones del papel:

:path=/static-assets/pdf/content-code-examples/how-to/custom-paper-size-modify-paper-size.cs

using IronPdf;
using IronPdf.Editing;

PdfDocument pdf = PdfDocument.FromFile("customPaperSize.pdf");

pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter);

pdf.SaveAs( "extendedLeftSide.pdf");

He aquí un ejemplo más completo que muestra varias modificaciones de la página:

// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);

// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);

// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);

// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);

// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);

// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);

// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);

// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);