Como usar a Viewport Virtual e o Zoom em C# no IronPDF

Quais são os modos de ajuste de papel no IronPDF?

Acesse o campo PaperFit em RenderingOptions para usar métodos predefinidos para tipos e modos de renderização específicos. Esses modos oferecem diferentes abordagens para renderizar conteúdo HTML em páginas PDF, semelhantes às técnicas usadas na criação de tamanhos de papel personalizados . Vamos examinar cada modo PaperFit renderizando a página principal da Wikipédia para comparação.

Os modos do PaperFit são compatíveis com diversos layouts de conteúdo, desde páginas web padrão até documentos especializados como recibos ou relatórios. Cada modo otimiza casos de uso específicos, garantindo que os PDFs mantenham o design e a legibilidade pretendidos, independentemente do formato original do conteúdo de origem.

Como faço para usar a renderização padrão do Chrome?

Este modo organiza as páginas do PDF tal como aparecem na pré-visualização de impressão do Google Chrome. Ele configura as opções de renderização para corresponder à aparência de uma página da web quando impressa a partir do Chrome. A viewport responsiva em CSS interpreta o tamanho de papel especificado com base em sua largura. Use o método UseChromeDefaultRendering para configurar isso.

A renderização padrão do Chrome mantém a consistência com as expectativas de impressão do navegador. Funciona bem para páginas web e documentos padrão, onde se deseja preservar o fluxo natural do conteúdo, tal como aparece nas operações típicas de impressão do navegador. Para cenários avançados que envolvem renderização em JavaScript , este modo garante a execução e exibição adequadas de conteúdo dinâmico.

: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")

Como faço para usar a renderização CSS responsiva?

No modo CSS responsivo, especifique a largura da viewport passando um valor para o método UseResponsiveCssRendering. O valor padrão de ViewPortWidth é 1280 pixels. A unidade de viewport é baseada em pixels, representando uma viewport virtual do navegador para designs CSS responsivos. Este modo é compatível com frameworks modernos e funciona com layouts CSS do Bootstrap e Flex .

O CSS responsivo define a renderização HTML com base no parâmetro ViewPortWidth , dimensionando o conteúdo para se ajustar à largura do tamanho de papel especificado. Essa abordagem é adequada para aplicações web modernas que utilizam princípios de design responsivo, garantindo que os PDFs mantenham o layout pretendido, independentemente do tamanho original da janela de visualização. Ao trabalhar com margens personalizadas , esse modo proporciona controle preciso sobre a adaptação do conteúdo a diferentes dimensões de página.

: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")

Como faço para usar a renderização em escala?

O método UseScaledRendering simula o comportamento da Pré-visualização de Impressão do Chrome para um tamanho de papel específico, ao mesmo tempo que oferece um nível de zoom ajustável. Este método dimensiona o conteúdo de acordo com a porcentagem de zoom inserida.

A renderização em escala oferece controle preciso sobre a aparência do conteúdo em PDFs. Ao contrário das abordagens com viewport fixa, este método permite o ajuste dinâmico do tamanho do conteúdo, tornando-o ideal para documentos que exigem legibilidade em diferentes escalas ou ao preparar PDFs para diversos contextos de exibição. Essa técnica complementa as configurações de orientação e rotação da página para uma apresentação ideal do documento.

: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")

Como faço para usar a opção "Ajustar à página"?

A opção "Ajustar à página" dimensiona o conteúdo para se ajustar ao tamanho de papel especificado. Ela mede a largura mínima do conteúdo HTML após a renderização e o dimensiona para caber na largura de uma folha de papel, sempre que possível. A largura mínima configurável em pixels garante a exibição correta e a capacidade de resposta às regras de layout CSS3.

Este modo lida com conteúdo que pode se estender por várias páginas horizontalmente. É ideal para tabelas, gráficos ou painéis extensos que precisam caber na largura de uma única página. O dimensionamento automático garante que todo o conteúdo permaneça visível sem a necessidade de rolagem horizontal, tornando-o ideal para gerar relatórios em PDF onde a legibilidade é importante.

: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")

Como faço para usar a renderização de alimentação contínua?

A renderização contínua cria um PDF de página única que exibe todo o conteúdo em uma única página, ideal para documentos como contas ou recibos. A largura padrão da página PDF é de 80 milímetros, com margens de 5 milímetros. Let's render the 'receipt.html' file to PDF.

Personalize a largura e a margem da página usando os parâmetros width e margin para maior flexibilidade. Este modo cria documentos concisos de uma única página. Ele gera recibos, faturas ou qualquer documento que exija fluxo contínuo sem quebras de página. Combinando isso com o controle de quebra de página de HTML para PDF , você pode criar layouts de documentos sofisticados para requisitos específicos.

: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")

Pronto para ver o que mais você pode fazer? Confira nossa página de tutoriais aqui: Converter PDFs