Cómo usar la vista virtual y el zoom en C#

Cómo utilizar C# Virtual Viewport y Zoom en IronPDF

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

En la representación de HTML a PDF, el viewport juega un papel vital en la determinación de cómo se capturará el diseño de la página web en el documento PDF resultante. Específicamente, se refiere al tamaño de pantalla virtual que el navegador debería representar en la página web.

El zoom, dentro del contexto de la representación de HTML a PDF, gobierna la escala del contenido de la página web en el documento PDF. La capacidad de ajustar a fondo el nivel de zoom proporciona un medio para ajustar el tamaño del contenido en el PDF resultante, asegurando que se alinee con el diseño y formato deseados.

Inicio rápido: Controlar Zoom y Viewport con IronPDF

Aprende a gestionar sin esfuerzo la configuración de zoom y viewport en tus conversiones de HTML a PDF usando IronPDF. Esta guía rápida proporciona un fragmento de código simple para que comiences con el escalado de contenido HTML. Con solo unas pocas líneas de código, puedes asegurar que tus PDFs se representen perfectamente, manteniendo elementos de diseño responsivos y diseños deseados. Experimenta hoy la facilidad de las potentes opciones de representación de IronPDF.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronPDF con el gestor de paquetes NuGet

    PM > Install-Package IronPdf

  2. Copie y ejecute este fragmento de código.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }
        .RenderUrlAsPdf("https://example.com")
        .SaveAs("zoomedViewport.pdf");
  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronPDF en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer


Modos de ajuste del papel

Accede al campo PaperFit en RenderingOptions para invocar un método preestablecido que se puede usar para un tipo y modo de representación específicos. Examinemos cada modo de PaperFit con más detalle al representar la conocida página de Wikipedia para la comparación.

Renderizado predeterminado de Chrome

Diseña las páginas PDF de la misma manera que aparecen en la vista previa de impresión de Google Chrome. Este método configura las opciones de representación para imitar la apariencia de una página web al imprimirse desde la vista previa de impresión de Google Chrome. El viewport CSS responsivo para el tamaño de papel especificado se interpreta según el ancho de ese tamaño de papel. Usa el método UseChromeDefaultRendering para configurar esto.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-default-chrome.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Chrome default rendering
renderer.RenderingOptions.PaperFit.UseChromeDefaultRendering();

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("chromeDefault.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Chrome default rendering
renderer.RenderingOptions.PaperFit.UseChromeDefaultRendering()

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

pdf.SaveAs("chromeDefault.pdf")
$vbLabelText   $csharpLabel

Renderizado CSS responsivo

En el modo CSS responsivo, puedes especificar un ancho de viewport pasando un valor al método UseResponsiveCssRendering. El ancho de viewport predeterminado es de 1280 píxeles. Como habrás notado, la unidad de viewport se basa en píxeles, representando un viewport de navegador virtual para diseños CSS responsivos.

Se utiliza CSS responsivo para definir la representación de HTML basada en el parámetro ViewPortWidth, escalando el contenido para ajustarse al ancho del tamaño de papel especificado.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-responsive-css.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Responsive CSS rendering
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1280);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("responsiveCss.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Responsive CSS rendering
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1280)

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

pdf.SaveAs("responsiveCss.pdf")
$vbLabelText   $csharpLabel

Renderizado a escala

El método UseScaledRendering adopta un diseño que imita el comportamiento de 'Vista previa de impresión de Chrome' para un tamaño de papel especificado. También proporciona un nivel de zoom adicional que los desarrolladores pueden ajustar manualmente. Este método permite la opción de escalar el contenido según el porcentaje de zoom de entrada.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-scaled.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Scaled rendering
renderer.RenderingOptions.PaperFit.UseScaledRendering(180);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("scaled.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Scaled rendering
renderer.RenderingOptions.PaperFit.UseScaledRendering(180)

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

pdf.SaveAs("scaled.pdf")
$vbLabelText   $csharpLabel

Renderización de páginas

Por el contrario, la representación 'ajustar a página' escala el contenido para ajustarse al tamaño de papel especificado. Mide el ancho mínimo del contenido HTML después de la representación y lo escala para ajustarse al ancho de una hoja de papel donde sea posible. El ancho mínimo de píxeles configurable se utiliza como un ancho mínimo basado en píxeles para el documento para asegurar una visualización correcta y respuesta a las reglas de diseño CSS3.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-fit-to-page.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Fit to page rendering
renderer.RenderingOptions.PaperFit.UseFitToPageRendering();

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("fitToPage.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Fit to page rendering
renderer.RenderingOptions.PaperFit.UseFitToPageRendering()

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

pdf.SaveAs("fitToPage.pdf")
$vbLabelText   $csharpLabel

Renderizado continuo de fuentes

La representación de alimentación continua crea un PDF de una sola página que obliga al ancho y altura total del contenido a ajustarse a una sola página, haciéndola adecuada para documentos como facturas de consumidores o recibos. El ancho predeterminado para la página PDF es de 80.0 milímetros, y el margen predeterminado es de 5 milímetros. Let's render the 'receipt.html' file to PDF.

La capacidad de personalizar el ancho de la página y el margen usando los parámetros 'ancho' y 'margen' proporciona flexibilidad, convirtiéndola en una opción conveniente para crear documentos concisos de una sola página.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-continuous-feed.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

int width = 90;
int margin = 0;

// Continuous feed rendering
renderer.RenderingOptions.PaperFit.UseContinuousFeedRendering(width, margin);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderHtmlFileAsPdf("receipt.html");

pdf.SaveAs("continuousFeed.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private width As Integer = 90
Private margin As Integer = 0

' Continuous feed rendering
renderer.RenderingOptions.PaperFit.UseContinuousFeedRendering(width, margin)

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderHtmlFileAsPdf("receipt.html")

pdf.SaveAs("continuousFeed.pdf")
$vbLabelText   $csharpLabel

¿Listo para ver qué más puedes hacer? Consulta nuestra página de tutoriales aquí: Convertir PDFs

Preguntas Frecuentes

¿Cómo puedo renderizar HTML a PDF con estilo CSS responsivo?

Puedes usar IronPDF para renderizar HTML con estilo CSS responsivo aprovechando su capacidad para soportar bootstrap y otros frameworks CSS, asegurando que el contenido de tu página web se capture de manera precisa en el PDF.

¿Cuál es la importancia del viewport en la conversión de HTML a PDF?

El viewport es crucial en la conversión de HTML a PDF ya que define el tamaño de pantalla virtual que el navegador usa para renderizar la página, impactando directamente en cómo el diseño y maquetación se capturan en el PDF.

¿Cómo ajusto el nivel de zoom al convertir HTML a PDF?

Con IronPDF, puedes ajustar el nivel de zoom especificando un factor de escala, lo cual te permite controlar el tamaño del contenido en el PDF para que coincida con el diseño y presentación deseados.

¿Qué es la característica de Renderizado Predeterminado de Chrome en IronPDF?

El Renderizado Predeterminado de Chrome en IronPDF simula la apariencia de una página web tal como se ve en la vista previa de impresión de Google Chrome, usando CSS responsivo para ajustar el contenido al tamaño de papel especificado.

¿Cómo funciona el Renderizado CSS Responsivo al generar PDFs?

El Renderizado CSS Responsivo en IronPDF te permite especificar un ancho de viewport, escalando el contenido HTML para que se ajuste al tamaño del papel. Por defecto, el ancho del viewport se establece en 1280 píxeles, asegurando que el contenido se ajuste bien dentro de las dimensiones del PDF.

¿Puedo usar el Renderizado Escalado para ajustes de zoom personalizados?

Sí, el Renderizado Escalado en IronPDF permite a los desarrolladores ajustar el nivel de zoom especificando un porcentaje, habilitando el control preciso sobre la escala del contenido de la página web en el PDF.

¿Cuál es el beneficio de 'Ajustar al tamaño de página' en la generación de PDF?

El 'Ajustar al tamaño de página' en IronPDF escala el contenido para que se ajuste al tamaño de papel elegido, asegurando que se mantenga un ancho mínimo de píxeles, lo cual es clave para lograr una visualización y consistencia de maquetación apropiadas.

¿Cómo difiere la Renderización de Alimentación Continua de otros modos de renderización?

La Renderización de Alimentación Continua en IronPDF crea un PDF de una sola página que acomoda el ancho y alto completo del contenido, lo que lo hace ideal para documentos como facturas de consumidor o recibos donde el contenido de página completa es necesario.

¿IronPDF es totalmente compatible con .NET 10, especialmente con los controles de ventana gráfica y zoom?

Sí, IronPDF es totalmente compatible con .NET 10. Admite todas las opciones de renderizado de la ventana gráfica y el zoom (por ejemplo, configuración de ViewPortWidth, uso de escalado de zoom y CSS adaptable) directamente en entornos .NET 10 sin necesidad de configuración adicional. ([ironpdf.com](https://ironpdf.com/blog/net-help/net-10-features/?utm_source=openai))

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 16,493,056 | Version: 2025.11 recién lanzado