Comment utiliser le Viewport Virtuel et le Zoom en C#

How to use Virtual Viewport and Zoom

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

Dans le rendu HTML vers PDF, le viewport joue un rôle essentiel pour déterminer comment la mise en page de la page web sera capturée dans le document PDF résultant. Plus précisément, il se réfère à la taille de l'écran virtuel que le navigateur doit utiliser pour rendre la page web.

Le zoom, dans le contexte du rendu HTML vers PDF, contrôle l'échelle du contenu de la page web dans le document PDF. La capacité à régler finement le niveau de zoom offre un moyen d'ajuster la taille du contenu dans le PDF résultant, assurant qu'il s'aligne avec votre mise en page et votre formatage souhaités.

en-tête:2(Démarrage rapide : Contrôlez le Zoom et le Viewport avec IronPDF)

Apprenez comment gérer facilement les paramètres de zoom et de viewport dans vos conversions HTML vers PDF avec IronPDF. Ce guide rapide fournit un extrait de code simple pour commencer à mettre à l'échelle le contenu HTML. Avec seulement quelques lignes de code, vous pouvez vous assurer que vos PDFs sont parfaitement rendus, en maintenant les éléments de conception réactifs et les mises en page souhaitées. Découvrez la facilité des puissantes options de rendu d'IronPDF dès aujourd'hui.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }
        .RenderUrlAsPdf("https://example.com")
        .SaveAs("zoomedViewport.pdf");
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

Flux de Travail Minimal (5 étapes)

  1. Téléchargez la bibliothèque C# IronPDF pour le rendu PDF et le contrôle du viewport
  2. Rendez du HTML en PDF en utilisant différents modes préconfigurés
  3. Utilisez les modes CSS par défaut de Chrome et réactif pour obtenir une mise en page automatique en PDF
  4. Utilisez le zoom pour agrandir le contenu
  5. Configurez 'ajustement à la page' et 'alimentation continue' pour des cas d'utilisation spécifiques


Modes d'Ajustement au Papier

Accédez au champ PaperFit dans RenderingOptions pour invoquer une méthode prédéfinie qui peut être utilisée pour un type et un mode de rendu spécifiques. Examinons chaque mode PaperFit plus en détail en rendant la célèbre page Wikipédia pour comparaison.

Rendu par Défaut de Chrome

Dispose les pages PDF de la même manière qu'elles apparaissent dans l'aperçu avant impression de Google Chrome. Cette méthode configure les options de rendu pour imiter l'apparence d'une page web lors de l'impression depuis l'aperçu avant impression de Google Chrome. Le viewport CSS réactif pour la taille de papier spécifiée est interprété en fonction de la largeur de cette taille de papier. Utilisez la méthode UseChromeDefaultRendering pour configurer cela.

: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

Rendu CSS Réactif

En mode CSS réactif, vous pouvez spécifier une largeur de viewport en passant une valeur à la méthode UseResponsiveCssRendering. La largeur de viewport par défaut est de 1280 pixels. Comme vous l'avez remarqué, l'unité de viewport est basée sur les pixels, représentant un viewport de navigateur virtuel pour les conceptions CSS réactives.

Le CSS réactif est utilisé pour définir le rendu du HTML en fonction du paramètre ViewPortWidth, en mettant le contenu à l'échelle pour qu'il s'adapte à la largeur de la taille de papier spécifiée.

: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

Rendu Échelonné

La méthode UseScaledRendering adopte une mise en page qui imite le comportement de 'Aperçu Avant Impression de Chrome' pour une taille de papier spécifiée. Elle fournit également un niveau de zoom supplémentaire que les développeurs peuvent ajuster manuellement. Cette méthode permet l'option de mettre l'échelle du contenu selon le pourcentage de zoom d'entrée.

: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

Rendu Ajusté à la Page

À l'inverse, le rendu 'ajusté à la page' met le contenu à l'échelle pour qu'il s'adapte à la taille de papier spécifiée. Il mesure la largeur minimale du contenu HTML après rendu et la met à l'échelle pour l'ajuster à la largeur d'une feuille de papier lorsque c'est possible. La largeur de pixel minimum configurable est utilisée comme largeur minimale basée sur les pixels pour le document afin d'assurer une affichage correct et une réactivité aux règles de mise en page 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

Rendu à Alimentation Continue

Le rendu à alimentation continue crée un PDF d'une seule page qui impose la largeur et la hauteur de l'ensemble du contenu de tenir sur une seule page, ce qui le rend approprié pour des documents comme les factures de consommateurs ou les reçus. La largeur par défaut de la page PDF est de 80,0 millimètres, et la marge par défaut est de 5 millimètres. Let's render the 'receipt.html' file to PDF.

La capacité à personnaliser la largeur de la page et la marge en utilisant les paramètres 'largeur' et 'marge' offre de la flexibilité, en faisant un choix pratique pour créer des documents concis d'une seule page.

: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

Prêt à voir ce que vous pouvez faire d'autre ? Consultez notre page de tutoriels ici : Convertir les PDFs

Questions Fréquemment Posées

Comment puis-je rendre du HTML en PDF avec une mise en forme CSS réactive ?

Vous pouvez utiliser IronPDF pour rendre du HTML avec une mise en forme CSS réactive en tirant parti de sa capacité à prendre en charge Bootstrap et d'autres frameworks CSS, garantissant que le contenu de votre page Web est capturé avec précision dans le PDF.

Quelle est l'importance de la fenêtre d'affichage dans la conversion HTML en PDF ?

La fenêtre d'affichage est cruciale dans la conversion HTML en PDF car elle définit la taille de l'écran virtuel que le navigateur utilise pour rendre la page, ce qui a un impact direct sur la façon dont la mise en page et le design sont capturés dans le PDF.

Comment ajuster le niveau de zoom lors de la conversion HTML en PDF ?

Avec IronPDF, vous pouvez ajuster le niveau de zoom en spécifiant un facteur de redimensionnement, ce qui vous permet de contrôler la taille du contenu dans le PDF pour qu'il corresponde à votre mise en page et présentation souhaitées.

Quelle est la fonctionnalité de rendu par défaut dans Chrome d'IronPDF ?

Le rendu par défaut de Chrome dans IronPDF simule l'apparence d'une page Web telle que vue dans l'aperçu avant impression de Google Chrome, en utilisant un CSS réactif pour ajuster le contenu à la taille de papier spécifiée.

Comment fonctionne le rendu CSS réactif lors de la génération de PDFs ?

Le rendu CSS réactif dans IronPDF vous permet de spécifier une largeur de fenêtre d'affichage, redimensionnant le contenu HTML pour s'adapter à la taille du papier. Par défaut, la largeur de la fenêtre d'affichage est fixée à 1280 pixels, garantissant que le contenu s'adapte bien aux dimensions du PDF.

Puis-je utiliser le rendu échelonné pour des ajustements de zoom personnalisés ?

Oui, le rendu échelonné dans IronPDF permet aux développeurs d'ajuster le niveau de zoom en spécifiant un pourcentage, permettant un contrôle précis sur le redimensionnement du contenu de la page Web dans le PDF.

Quel est l'avantage du rendu 'Adapter à la page' dans la génération de PDF ?

Le rendu 'Adapter à la page' dans IronPDF redimensionne le contenu pour s'adapter à la taille de papier choisie, garantissant qu'une largeur de pixel minimale est maintenue, ce qui est essentiel pour obtenir un affichage et une cohérence de la mise en page appropriés.

Comment le rendu d'alimentation continue diffère-t-il des autres modes de rendu ?

Le rendu d'alimentation continue dans IronPDF crée un PDF d'une seule page qui accueille la largeur et la hauteur de l'intégralité du contenu, ce qui le rend idéal pour les documents comme les factures ou reçus où le contenu pleine page est nécessaire.

IronPDF est-il entièrement compatible avec .NET 10, notamment en ce qui concerne les commandes de fenêtre d'affichage et de zoom ?

Oui, IronPDF est entièrement compatible avec .NET 10. Il prend en charge toutes les options de rendu de la fenêtre d'affichage et du zoom (par exemple, la définition de ViewPortWidth, l'utilisation de la mise à l'échelle du zoom, le CSS réactif) directement dans les environnements .NET 10 sans configuration supplémentaire. ([ironpdf.com](https://ironpdf.com/blog/net-help/net-10-features/?utm_source=openai))

Curtis Chau
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 16,154,058 | Version : 2025.11 vient de sortir