Cómo renderizar PDFs con tamaño de papel personalizado en C
IronPDF le permite renderizar archivos PDF con tamaños de papel personalizados en C# utilizando la clase ChromePdfRenderer y configurando dimensiones específicas a través de métodos como SetCustomPaperSizeInInches(), lo que permite un control preciso sobre las dimensiones del documento para diseños especiales como carteles o pancartas.
Un tamaño de papel personalizado se refiere a un tamaño de papel no estándar definido por el usuario, en lugar de ser un tamaño estándar como A4 o tamaño carta (8.5 x 11 pulgadas). Los tamaños de papel personalizados se utilizan a menudo al imprimir documentos que requieren un diseño único o específico, como carteles, pancartas o documentos especiales. Esta flexibilidad es esencial cuando se trabaja con proyectos de conversión de HTML a PDF que requieren dimensiones específicas.
Descubra la amplia gama de tamaños de papel disponibles con IronPDF, con una selección completa para satisfacer sus necesidades.
Inicio rápido: definir tamaños de papel personalizados en IronPDF
En esta guía rápida, aprenda a configurar tamaños de papel personalizados utilizando IronPDF con solo unas pocas líneas de código. Con IronPDF, puede personalizar fácilmente las dimensiones del PDF definiendo medidas exactas de ancho y alto en la unidad que prefiera. Esta flexibilidad es ideal para crear documentos con requisitos de diseño únicos, como carteles o pancartas. Comience por descargar la biblioteca IronPDF a través de NuGet y siga este ejemplo para configurar el tamaño de papel deseado sin esfuerzo.
-
Instala IronPDF con el Administrador de Paquetes NuGet
PM > Install-Package IronPdf -
Copie y ejecute este fragmento de código.
var renderer = new IronPdf.ChromePdfRenderer { RenderingOptions = { PaperSize = IronPdf.Rendering.PdfPaperSize.Custom } }; renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7); renderer.RenderHtmlAsPdf("<h1>Custom size</h1>").SaveAs("custom-size.pdf") -
Despliegue para probar en su entorno real
Comienza a usar IronPDF en tu proyecto hoy mismo con una prueba gratuita
Flujo de trabajo mínimo (5 pasos)
- Descargue IronPDF de NuGet para configurar tamaños de papel personalizados en PDF
- Instancia la clase ChromePdfRenderer en C#
- Accede a las RenderingOptions en el nuevo objeto
- Invocar uno de los métodos `SetCustomPaperSize` en función de la unidad de medida
- Renderiza y exporta el documento PDF
¿Cómo se utilizan los tamaños de papel estándar?
Primero, crea una instancia de la clase ChromePdfRenderer. Luego, utilice la propiedad RenderingOptions del objeto recién creado para modificar PaperSize. Establezca uno de los valores predefinidos de la enumeración PdfPaperSize para especificar el tamaño de papel deseado. Ofrecemos más de 100 tamaños de papel estándar predefinidos para su comodidad.
Al trabajar con opciones de representación de PDF, IronPDF proporciona un control exhaustivo sobre el formato de los documentos. Los tamaños de papel estándar incluyen formatos de uso común como A4, Carta, Legal y muchos estándares internacionales.
¿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");
Imports IronPdf
Imports IronPdf.Rendering
Private renderer As New ChromePdfRenderer()
' Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
Dim pdf As PdfDocument = 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: Establezca un tamaño de papel de salida para páginas PDF con tamaños predefinidos como carta, A3, A4, etc.ForcePaperSize: Fuerza que los tamaños de página sean exactamente los especificados medianteIronPdf.ChromePdfRenderOptions.PaperSizeal 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 el ancho y la altura del tamaño de papel estándar como objetos Length. La clase Length es increíblemente versátil y le permite convertir sin esfuerzo estas dimensiones en una variedad de unidades, que incluyen:
- 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();
Imports IronPdf.Rendering
Private A4WidthInPixel As Double = PdfPaperSize.A4.ToMillimeters().width.ToPixel()
Private A4HeightInCentimeter As Double = 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.
¿Cómo puedo crear tamaños de papel personalizados?
Primero, comenzamos instanciando la clase ChromePdfRenderer. Desde el objeto recién creado, podemos acceder al RenderingOptions para aplicar un tamaño de papel personalizado al documento PDF recién generado. Hay cuatro métodos que se pueden usar para establecer el tamaño de papel de salida para las páginas PDF, cada uno basado en una unidad de medida diferente:
SetCustomPaperSizeInCentimeters: Las dimensiones están encentimeters.SetCustomPaperSizeInInches: Las dimensiones están eninches.SetCustomPaperSizeInMillimeters: Las dimensiones están enmillimeters.SetCustomPaperSizeInPixelsOrPoints: Las dimensiones están enpixels or points.
Al crear tamaños de papel personalizados, es importante tener en cuenta cómo interactuarán con encabezados y pies de página, así como con configuraciones de orientación de página.
¿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");
Imports IronPdf
Private renderer As New ChromePdfRenderer()
' Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15)
Dim pdf As PdfDocument = 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
' 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.
¿Cómo puedo modificar las dimensiones del papel?
En un documento PDF existente o en un PDF recién generado, se puede modificar el tamaño de cada página utilizando el método ExtendPage. Este método te permite especificar el índice de la página objetivo, los valores para modificar cada uno de los cuatro lados y las unidades de medida. Los valores para cada lado pueden ser negativos, lo que reducirá ese lado en particular, o positivos, lo que extenderá ese lado.
Esta función resulta especialmente útil cuando es necesario ajustar los PDF una vez creados, por ejemplo, al combinar varios PDF con diferentes tamaños de página o al preparar documentos para su impresión.
¿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 (
millimeters, inches, 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");
Imports IronPdf
Imports IronPdf.Editing
Private pdf As PdfDocument = 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);
' 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)
Mejores prácticas para tamaños de papel personalizados
Cuando trabaje con tamaños de papel personalizados en IronPDF, tenga en cuenta estas prácticas recomendadas:
-
Prueba diferentes unidades: Mientras trabajas con tamaños personalizados, prueba qué unidad de medida funciona mejor para tu caso de uso. Los píxeles son ideales para la presentación en pantalla, mientras que los milímetros o pulgadas son mejores para la impresión.
-
Considere los márgenes de impresión: Al crear PDF para imprimir, recuerde tener en cuenta los márgenes de impresión. La mayoría de las impresoras no pueden imprimir hasta el borde del papel.
-
Diseño responsivo: Cuando convierta HTML a PDF, asegúrese de que su HTML utiliza principios de diseño responsivo para adaptarse a diferentes tamaños de papel.
-
Optimización del rendimiento: Los tamaños de papel personalizados muy grandes pueden afectar al rendimiento. Considere el uso de compresión para documentos de gran tamaño.
- Compatibilidad: pruebe sus PDF de tamaño personalizado en diferentes visores de PDF para garantizar la compatibilidad, especialmente si utiliza dimensiones no estándar.
¿Listo para ver qué más puede hacer? Consulte nuestra página de tutoriales aquí: Crear PDFs
Preguntas Frecuentes
¿Cómo establezco tamaños de papel personalizados para documentos PDF en C#?
Con IronPDF, puede establecer tamaños de papel personalizados utilizando la clase ChromePdfRenderer. Simplemente establezca la propiedad PaperSize a PdfPaperSize.Custom en las RenderingOptions, luego utilice métodos como SetCustomPaperSizeInInches() para definir sus dimensiones específicas. Por ejemplo: renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7).
¿Qué unidades de medida puedo utilizar para los tamaños de papel personalizados?
IronPDF soporta múltiples unidades de medida para tamaños de papel personalizados a través de diferentes métodos SetCustomPaperSize. Puede especificar dimensiones en pulgadas, centímetros, milímetros o píxeles, lo que lo hace flexible para diversos estándares internacionales y requisitos de proyecto.
¿Cuándo necesitaría utilizar tamaños de papel personalizados en lugar de tamaños estándar?
Los tamaños de papel personalizados en IronPDF son ideales para crear PDF con diseños únicos, como carteles, pancartas, documentos especializados o cualquier diseño que no se ajuste a formatos estándar como A4 o Carta. Esta flexibilidad es especialmente útil para proyectos de conversión de HTML a PDF que requieren dimensiones específicas.
¿Cuántos tamaños de papel estándar predefinidos hay disponibles?
IronPDF ofrece más de 100 tamaños de papel estándar predefinidos a través del enum PdfPaperSize, incluyendo formatos de uso común como A4, Carta, Legal, y muchos estándares internacionales, proporcionando opciones completas para la mayoría de los requisitos de documentos.
¿Cuáles son los pasos para implementar tamaños de papel personalizados?
Para implementar tamaños de papel personalizados con IronPDF: 1) Descargue IronPDF a través de NuGet, 2) Cree una instancia de ChromePdfRenderer, 3) Acceda a la propiedad RenderingOptions, 4) Llame a un método SetCustomPaperSize con las dimensiones que desee, y 5) Renderice y guarde su documento PDF.

