Comment utiliser le Viewport Virtuel et le Zoom en C#

Comment utiliser C&#35 ; Virtual Viewport et Zoom dans IronPDF

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

Contrôlez le viewport et le zoom dans IronPDF en utilisant la propriété RenderingOptions pour définir les valeurs ViewPortWidth et Zoom, ou tirez parti des modes préréglés PaperFit pour la gestion automatique de la mise en page lors de la conversion HTML en PDF.

<TODO : Ajouter une image ici -->

Dans le rendu HTML vers PDF, le viewport détermine comment les mises en page web sont capturées dans le document PDF résultant. Il représente la taille de l'écran virtuel que le navigateur utilise pour rendre la page web. Lorsque vous travaillez avec le moteur de rendu Chrome d'IronPdf, il est essentiel de comprendre les paramètres du viewport pour obtenir des résultats précis.

Zoom contrôle la mise à l'échelle du contenu de la page web dans le document PDF. Le réglage précis du niveau de zoom permet d'ajuster la taille du contenu dans le PDF, ce qui garantit une mise en page et un formatage corrects. Cette fonctionnalité est particulièrement utile lors de la manipulation de mises en page CSS responsives qui doivent s'adapter à différentes tailles de page.

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

Gérez les paramètres de zoom et de fenêtre dans vos conversions HTML vers PDF à l'aide d'IronPDF. Ce guide fournit un extrait de code simple pour commencer à mettre à l'échelle du contenu HTML. Avec un minimum de code, vous pouvez vous assurer que les PDF s'affichent correctement tout en conservant les éléments responsive design et les mises en page souhaitées.

Nuget IconCommencez dès maintenant à créer des PDF avec NuGet :

  1. Installez IronPDF avec le gestionnaire de packages NuGet

    PM > Install-Package IronPdf

  2. Copiez et exécutez cet extrait de code.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }
        .RenderUrlAsPdf("https://example.com")
        .SaveAs("zoomedViewport.pdf");
  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronPDF dans votre projet dès aujourd'hui grâce à un essai gratuit.
    arrow pointer


Quels sont les modes d'adaptation du papier dans IronPDF?

Accédez au champ PaperFit dans RenderingOptions pour utiliser des méthodes prédéfinies pour des types et des modes de rendu spécifiques. Ces modes fournissent différentes approches pour le rendu du contenu HTML sur les pages PDF, similaires aux techniques utilisées lors de la création de formats de papier personnalisés. Examinons chaque mode de PaperFit en rendant la page principale de Wikipédia à des fins de comparaison.

Les modes de PaperFit gèrent diverses mises en page de contenu, des pages web standard aux documents spécialisés tels que les reçus ou les rapports. Chaque mode est optimisé pour des cas d'utilisation spécifiques, garantissant que les PDF conservent la conception et la lisibilité voulues, quel que soit le format d'origine du contenu source.

Comment utiliser le rendu par défaut de Chrome?

<TODO : Ajouter une image ici -->

Ce mode présente les pages PDF telles qu'elles apparaissent dans l'aperçu avant impression de Google Chrome. Elle configure les options de rendu pour qu'elles correspondent à l'apparence d'une page web lorsqu'elle est imprimée à partir de Chrome. La fenêtre CSS réactive interprète le format de papier spécifié en fonction de sa largeur. Utilisez la méthode UseChromeDefaultRendering pour configurer ceci.

Le rendu par défaut de Chrome maintient la cohérence avec les attentes des navigateurs en matière d'impression. Elle fonctionne bien pour les pages web et les documents standard où vous souhaitez préserver le flux naturel du contenu tel qu'il apparaît dans les opérations d'impression typiques d'un navigateur. Pour les scénarios avancés impliquant le rendu JavaScript, ce mode garantit une exécution et un affichage corrects du contenu dynamique.

: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");
$vbLabelText   $csharpLabel

Comment utiliser le rendu CSS réactif?

<TODO : Ajouter une image ici -->

En mode CSS réactif, spécifiez une largeur de fenêtre en passant une valeur à la méthode UseResponsiveCssRendering. La ViewPortWidth par défaut est de 1280 pixels. L'unité de visualisation est basée sur le pixel, représentant une fenêtre de visualisation virtuelle du navigateur pour les conceptions CSS réactives. Ce mode prend en charge les cadres modernes et fonctionne avec Bootstrap et Flex CSS layouts.

Responsive CSS définit le rendu HTML en fonction du paramètre ViewPortWidth, mettant à l'échelle le contenu pour l'adapter à la largeur du format de papier spécifié. Cette approche convient aux applications web modernes qui utilisent les principes du responsive design, garantissant que les PDF conservent la mise en page prévue quelle que soit la taille de l'affichage d'origine. Lorsque l'on travaille avec des marges personnalisées, ce mode permet de contrôler avec précision l'adaptation du contenu aux différentes dimensions de la page.

: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");
$vbLabelText   $csharpLabel

Comment utiliser le rendu à l'échelle?

La méthode UseScaledRendering imite le comportement de l'aperçu avant impression de Chrome pour un format de papier spécifié tout en fournissant un niveau de zoom réglable. Cette méthode permet d'adapter le contenu en fonction du pourcentage de zoom saisi.

Le rendu à l'échelle permet un contrôle précis de l'apparence du contenu dans les PDF. Contrairement aux approches à fenêtre fixe, cette méthode permet un ajustement dynamique de la taille du contenu, ce qui la rend idéale pour les documents nécessitant une lisibilité à différentes échelles ou lors de la préparation de PDF pour divers contextes d'affichage. Cette technique complète les paramètres d'orientation et de rotation des pages pour une présentation optimale des documents.

: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");
$vbLabelText   $csharpLabel

Comment utiliser la fonction Fit to Page Rendering?

Le rendu adapté à la page adapte le contenu au format de papier spécifié. Il mesure la largeur minimale du contenu HTML après le rendu et l'adapte, dans la mesure du possible, à la largeur d'une feuille de papier. La largeur de pixel minimale configurable garantit un affichage correct et une réactivité aux règles de mise en page CSS3.

Ce mode permet de traiter des contenus qui peuvent s'étendre sur plusieurs pages horizontalement. Elle convient parfaitement aux tableaux larges, aux graphiques ou aux tableaux de bord qui doivent tenir sur une seule page. La mise à l'échelle automatique garantit que tout le contenu reste visible sans défilement horizontal, ce qui en fait un outil idéal pour générer des rapports PDF où la lisibilité est 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");
$vbLabelText   $csharpLabel

Comment utiliser le Continuous Feed Rendering?

Le rendu d'alimentation continue crée un PDF d'une seule page qui contient tout le contenu sur une seule page, ce qui convient à des documents tels que des factures ou des reçus de consommateurs. La largeur de page PDF par défaut est de 80,0 millimètres avec des marges de 5 millimètres. Let's render the 'receipt.html' file to PDF.

Personnalisez la largeur et la marge de la page à l'aide des paramètres width et margin pour plus de flexibilité. Ce mode permet de créer des documents concis d'une seule page. Il génère des reçus, des factures ou tout autre document nécessitant un flux continu sans saut de page. Combiné avec le contrôle des sauts de page du HTML au PDF, vous pouvez créer des mises en page de documents sophistiquées pour répondre à des besoins spécifiques.

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

Qu'est-ce que le viewport dans la conversion HTML vers PDF ?

Dans IronPDF, le viewport représente la taille de l'écran virtuel que le moteur de rendu Chrome utilise pour rendre les pages web avant de les convertir en PDF. Il détermine la manière dont les dispositions des pages web sont capturées dans le document PDF résultant, ce qui est essentiel pour obtenir des résultats de rendu précis.

Comment puis-je contrôler le zoom et la largeur de la fenêtre en une seule ligne de code ?

Vous pouvez contrôler à la fois la largeur de la fenêtre et le zoom dans IronPDF en utilisant une seule ligne : new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }.RenderUrlAsPdf('https://example.com').SaveAs('zoomedViewport.pdf'). Ceci définit la fenêtre d'affichage à 1280 pixels et applique un facteur de zoom de 1,8.

Qu'est-ce que les modes PaperFit ?

Les modes PaperFit dans IronPDF sont des méthodes prédéfinies accessibles via le champ RenderingOptions.PaperFit qui fournissent différentes approches pour le rendu du contenu HTML sur les pages PDF. Chaque mode est optimisé pour des cas d'utilisation spécifiques tels que les pages web standard, les reçus ou les rapports, ce qui garantit que les PDF conservent la conception et la lisibilité prévues.

Pourquoi le contrôle du zoom est-il important pour les mises en page CSS réactives ?

Le contrôle du zoom dans IronPDF est particulièrement utile lors de la manipulation de mises en page CSS réactives qui doivent s'adapter à différentes tailles de page. Le réglage précis du niveau de zoom permet d'ajuster la taille du contenu dans le PDF, ce qui garantit une mise en page et un formatage corrects tout en préservant les éléments de conception responsive.

Quel est le moteur de rendu utilisé pour les fonctions d'affichage et de zoom ?

Les fonctions de visualisation et de zoom d'IronPDF utilisent le moteur de rendu Chrome. Cela garantit un rendu précis et cohérent des pages web, correspondant à la façon dont elles s'afficheraient dans Google Chrome avant d'être converties en PDF.

Qu'est-ce que le mode de rendu par défaut de Chrome ?

Chrome Default Rendering est un mode PaperFit d'IronPDF qui présente les pages PDF telles qu'elles apparaissent dans l'aperçu avant impression de Google Chrome. Il configure les options de rendu pour correspondre à l'apparence d'une page web lorsqu'elle est imprimée à partir de Chrome, en interprétant le responsive CSS viewport en fonction du format de papier spécifié.

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 17,012,929 | Version : 2025.12 vient de sortir