Cómo utilizar las opciones de renderización

This article was translated from English: Does it need improvement?
Translated
View the article in English

por Chaknith Bin

Las opciones de renderizado en la generación de PDF se refieren a los ajustes y configuraciones que determinan cómo se crea, muestra e imprime un documento PDF. Estas opciones pueden incluir una amplia gama de configuraciones, como renderizar elementos de campos de formulario, habilitar JavaScript, generar una tabla de contenidos, añadir encabezados y pies de página, ajustar márgenes, establecer el tamaño de papel del PDF, y más.

La clase ChromePdfRenderer en IronPDF ofrece varias opciones de renderizado que permiten a los usuarios personalizar cómo se generan los PDFs. Incluye PaperFit, un gestor que controla cómo se organiza el contenido en las páginas PDF, ofreciendo diferentes estilos de diseño como diseños responsivos CSS3 o alimentación continua.

Comience con IronPDF

Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.

Primer Paso:
green arrow pointer



Ejemplo de Opciones de Renderizado

A pesar de que muchas propiedades de opciones de renderizado están específicamente diseñadas para la conversión de HTML a PDF, también pueden ser utilizadas en otros tipos de conversiones de PDF. Vamos a renderizar la sintaxis de Markdown a PDF y usar las opciones de renderizado para configurar la salida del PDF.

:path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs
using IronPdf;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure rendering options
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<h1>Header Content</h1>"
};
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150);
renderer.RenderingOptions.MarginTop = 0;

// Markdown string
string md = "This is some **bold** and *italic* text.";

// Render from markdown string
PdfDocument pdf = renderer.RenderMarkdownStringAsPdf(md);

// Save the PDF
pdf.SaveAs("renderingOptions.pdf");
Imports IronPdf

' Instantiate Renderer
Private renderer As New ChromePdfRenderer()

' Configure rendering options
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {.HtmlFragment = "<h1>Header Content</h1>"}
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150)
renderer.RenderingOptions.MarginTop = 0

' Markdown string
Dim md As String = "This is some **bold** and *italic* text."

' Render from markdown string
Dim pdf As PdfDocument = renderer.RenderMarkdownStringAsPdf(md)

' Save the PDF
pdf.SaveAs("renderingOptions.pdf")
VB   C#

Todas las opciones de renderizado

Tenemos algunas opciones avanzadas que definen las opciones de renderizado del PDF, como el ajuste de los márgenes,

orientación del papel, tamaño del papel, etc.

A continuación encontrará un cuadro que ilustra las distintas opciones.

ClaseChromePdfRenderer
DescripciónPermite definir las opciones de impresión del PDF, como el tamaño del papel, los PPP, los encabezados y los pies de página.
Propiedades / funcionesTipoDescripción
CustomCookiesDictionary<cadena, cadena>Cookies personalizadas para el renderizado HTML. Las cookies no persisten entre renderizaciones y deben configurarse cada vez.
PaperFitVirtualPaperLayoutManagerUn gestor para configurar diseños de papel virtual, controlando cómo se presentará el contenido en las páginas de "papel" PDF. Incluye opciones para Default Chrome Behavior, Zoomed, Responsive CSS3 Layouts, Scale-To-Page & Continuous Feed style PDF page setups.
UseMarginsOnHeaderAndFooterUseMarginsUtilizar los valores de margen del documento principal al representar los encabezados y pies de página.
CreatePdfFormsFromHtmlboolConvierte todos los elementos de formulario HTML en formularios PDF editables. El valor por defecto es true.
CssMediaTypePdfCssMediaTypeHabilita los estilos CSS y las hojas de estilo Media="screen". El valor por defecto es PdfCssMediaType.Screen.
CustomCssUrlcadenaPermite aplicar una hoja de estilo CSS personalizada al HTML antes de la visualización. Puede ser una ruta de archivo local o una URL remota. Sólo aplicable al convertir HTML a PDF.
Activar JavaScriptboolPermite ejecutar JavaScript y JSON antes de renderizar la página. Ideal para imprimir desde aplicaciones Ajax / Angular. El valor por defecto es false.
EnableMathematicalLaTexboolPermite la representación de elementos matemáticos LaTeX.
JavascriptcadenaUna cadena JavaScript personalizada que se ejecutará después de que se haya cargado todo el HTML pero antes de la renderización del PDF.
JavascriptMessageListenerStringDelegateUn método de devolución de llamada que se invocará cada vez que un mensaje de la consola JavaScript del navegador esté disponible.
NúmeroPrimeraPáginaintNúmero de la primera página que se utilizará en los encabezados y pies de página del PDF. El valor por defecto es 1.
TablaDeContenidosTableOfContentsTypesGenera una tabla de contenidos en el lugar del documento HTML donde se encuentra un elemento con id "ironpdf-toc".
Escala de grisesboolImprime un PDF en blanco y negro. El valor por defecto es false.
Cabecera de textoITextHeaderFooterEstablece el contenido del pie de página de cada página PDF como texto, admite la fusión de correo y convierte automáticamente las URL en hipervínculos.
Pie de texto
HtmlHeaderHtmlHeaderFooterEstablece el contenido de la cabecera de cada página PDF como HTML. Admite la fusión de correo.
HtmlFooter
Codificación de entradaCodificaciónLa codificación de caracteres de entrada como cadena. El valor por defecto es Encoding.UTF8.
MarginTopdobleMargen superior del PDF "papel" en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25.
MarginRightdobleMargen derecho del PDF "papel" en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25.
MarginBottomdobleMargen "papel" inferior del PDF en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25.
MargenIzquierdodobleMargen "papel" izquierdo del PDF en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25.
Orientación del papelPdfPaperOrientationLa orientación del papel PDF, como Vertical u Horizontal. El valor predeterminado es Vertical.
TamañoPapelPdfPaperSizeEstablece el tamaño del papel
SetCustomPaperSizeinCentimetersdobleEstablece el tamaño del papel en centímetros.
SetCustomPaperSizeInInchesEstablece el tamaño del papel en pulgadas.
SetCustomPaperSizeinMilimetersEstablece el tamaño del papel en milímetros.
SetCustomPaperSizeenPixelsOrPointsEstablece el tamaño del papel en píxeles de pantalla o puntos de impresora.
PrintHtmlBackgroundsBooleanoIndica si se imprimen los colores de fondo y las imágenes de HTML. El valor por defecto es true.
RequestContextRequestContextsContexto de la solicitud para este render, determinando el aislamiento de ciertos recursos como las cookies.
Tiempo de esperaEnteroTiempo de espera en segundos. El valor por defecto es 60.
TítuloCadenaMetadatos de nombre y título de documento PDF, útiles para la fusión de correo y la asignación automática de nombres de archivo en las extensiones IronPdf MVC y Razor.
ForzarTamañoDePapelBooleanoFuerza que los tamaños de página sean exactamente los especificados mediante IronPdf.ChromePdfRenderOptions.PaperSize al cambiar el tamaño de la página después de generar un PDF a partir de HTML. Ayuda a corregir pequeños errores en el tamaño de página al renderizar HTML a PDF.
Espere enEspere enUn objeto envoltorio que contiene la configuración del mecanismo wait-for para que los usuarios esperen ciertos eventos antes de renderizar. Por defecto, no esperará nada.
Chaknith related to Todas las opciones de renderizado

Chaknith Bin

Ingeniero de software

Chaknith es el Sherlock Holmes de los desarrolladores. La primera vez que se le ocurrió que podría tener futuro en la ingeniería de software fue cuando hacía retos de código por diversión. Su trabajo se centra en IronXL e IronBarcode, pero se enorgullece de ayudar a los clientes con todos los productos. Chaknith aprovecha sus conocimientos, adquiridos hablando directamente con los clientes, para ayudar a mejorar los propios productos. Sus comentarios anecdóticos van más allá de los tickets de Jira y apoyan el desarrollo de productos, la documentación y el marketing, para mejorar la experiencia general del cliente.Cuando no está en la oficina, se le puede encontrar aprendiendo sobre aprendizaje automático, codificación y senderismo.