1. IronPDF
  2. Guides pratiques
  3. Tracer une ligne & un rectangle
Comment tracer des lignes et des rectangles sur des PDFs en C#

Comment dessiner des lignes et des rectangles sur des PDF en C#;

Curtis Chau
Curtis Chau
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Pour dessiner des lignes et des rectangles sur des PDF en C#, utilisez les méthodes DrawLine et DrawRectangle d'IronPDF sur un objet PdfDocument, en spécifiant les coordonnées, les couleurs et les dimensions pour ajouter des formes géométriques professionnelles par programme.

Dessiner des lignes et des rectangles sur un document PDF fait référence au processus d'ajout de formes géométriques, spécifiquement des lignes et des rectangles, au contenu d'un fichier PDF. Cela se fait souvent par programmation en utilisant un langage de programmation tel que C# ou VB.NET et une bibliothèque comme IronPDF.

Lorsque vous dessinez une ligne, vous créez un segment de ligne visible avec des points de début et de fin spécifiés. De même, lorsque vous dessinez un rectangle, vous définissez une forme à quatre côtés avec des dimensions et des positions spécifiques. Ces capacités de dessin sont essentielles pour créer des formulaires, des diagrammes, des annotations et mettre en évidence des sections importantes dans des documents PDF. Les fonctions de dessin d'IronPDF s'intègrent parfaitement à ses autres capacités d'édition de PDF, ce qui permet aux développeurs d'améliorer les PDF existants ou de créer des documents entièrement nouveaux avec des graphiques personnalisés.

en-tête:2(Guide rapide : Dessiner des lignes et des rectangles avec IronPDF)

Ajoutez des lignes et des rectangles à vos documents PDF à l'aide d'IronPDF. Ce guide montre comment utiliser la méthode DrawLine pour les lignes et la méthode DrawRectangle pour les rectangles. Avec seulement quelques lignes de code, vous pouvez créer des éléments graphiques dynamiques dans vos PDF, en ajoutant des visuels de qualité professionnelle à vos applications.

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.

    IronPdf.PdfDocument pdf = IronPdf.PdfDocument.FromFile("input.pdf");
pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2);
pdf.SaveAs("output.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

Flux de travail minimal (5 étapes)

  1. Télécharger la bibliothèque IronPDF C# depuis NuGet
  2. Importez le document PDF cible ou rendez-le depuis HTML
  3. Utiliser la méthode DrawLine pour ajouter des lignes aux PDF
  4. Utiliser la méthode DrawRectangle pour ajouter des rectangles
  5. Exportez le document PDF modifié


Comment tracer des lignes sur des PDF en C#?

<TODO : Ajouter une image ici -->

En utilisant la méthode DrawLine disponible pour l'objet PdfDocument, vous pouvez ajouter des lignes à un PDF existant. L'utilisation de la classe Color proposée par IronDrawing API Documentation ouvre la possibilité d'appliquer une ligne avec une couleur issue d'un code couleur HEX. Cette fonction vous permet de créer des soulignements, des intercalaires, des bordures ou des diagrammes personnalisés directement dans vos documents PDF.

La méthode DrawLine accepte plusieurs paramètres qui vous permettent de contrôler précisément l'apparence de vos lignes :

  • Index de page : spécifie la page sur laquelle dessiner (indexation à base zéro)
  • Point de départ : Les coordonnées de départ (X, Y)
  • Point final : Les coordonnées de fin (X, Y)
  • Largeur : L'épaisseur en points
  • <Couleur : La couleur de la ligne en utilisant des codes hexadécimaux ou des couleurs prédéfinies
:path=/static-assets/pdf/content-code-examples/how-to/draw-line-and-rectangle-draw-line.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Configure the required parameters
int pageIndex = 0;
var start = new IronSoftware.Drawing.PointF(200,150);
var end = new IronSoftware.Drawing.PointF(1000,150);
int width = 10;
var color = new IronSoftware.Drawing.Color("#000000");

// Draw line on PDF
pdf.DrawLine(pageIndex, start, end, width, color);

pdf.SaveAs("drawLine.pdf");
$vbLabelText   $csharpLabel

Pour des fonctionnalités de manipulation de PDF plus avancées, consultez la Référence API qui fournit une documentation complète pour toutes les méthodes et propriétés disponibles.

À quoi ressemble la sortie de dessin au trait?

Techniques avancées de dessin au trait

Lorsque vous travaillez avec des lignes dans des PDF, vous pouvez vouloir créer des motifs ou des dessins plus complexes. Voici un exemple de dessin de plusieurs lignes pour créer un motif de grille :

// Create a grid pattern with horizontal and vertical lines
for (int i = 0; i < 5; i++)
{
    // Draw horizontal lines
    var horizontalStart = new IronSoftware.Drawing.PointF(100, 100 + (i * 100));
    var horizontalEnd = new IronSoftware.Drawing.PointF(500, 100 + (i * 100));
    pdf.DrawLine(0, horizontalStart, horizontalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));

    // Draw vertical lines
    var verticalStart = new IronSoftware.Drawing.PointF(100 + (i * 100), 100);
    var verticalEnd = new IronSoftware.Drawing.PointF(100 + (i * 100), 500);
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));
}
// Create a grid pattern with horizontal and vertical lines
for (int i = 0; i < 5; i++)
{
    // Draw horizontal lines
    var horizontalStart = new IronSoftware.Drawing.PointF(100, 100 + (i * 100));
    var horizontalEnd = new IronSoftware.Drawing.PointF(500, 100 + (i * 100));
    pdf.DrawLine(0, horizontalStart, horizontalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));

    // Draw vertical lines
    var verticalStart = new IronSoftware.Drawing.PointF(100 + (i * 100), 100);
    var verticalEnd = new IronSoftware.Drawing.PointF(100 + (i * 100), 500);
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));
}
$vbLabelText   $csharpLabel

Cette technique est particulièrement utile pour créer des formulaires ou des mises en page structurées dans vos PDF. Pour plus d'informations sur la création de formulaires, consultez notre guide sur la création de formulaires PDF.

Comment dessiner des rectangles sur des PDF en C#?

<TODO : Ajouter une image ici -->

Pour ajouter des rectangles aux PDFs, utilisez la méthode DrawRectangle. Une fois le document PDF ouvert ou rendu, cette méthode est disponible pour l'objet PdfDocument. Configurez les coordonnées, la largeur et la hauteur du rectangle avec la classe RectangleF proposée par IronDrawing API Documentation.

Les rectangles sont des formes polyvalentes qui peuvent être utilisées à diverses fins dans les documents PDF :

  • Créer des bordures autour du contenu important
  • Mise en évidence de parties de texte ou d'images
  • Construction de champs de formulaire et de cases à cocher
  • Conception d'en-têtes et de pieds de page
  • Création de séparateurs visuels entre les sections

La méthode DrawRectangle offre des options pour les couleurs de contour et de remplissage, ce qui vous permet de créer des rectangles délimités, des rectangles remplis ou une combinaison des deux. Cette flexibilité en fait un outil idéal pour le filigrane personnalisé et d'autres améliorations visuelles.

:path=/static-assets/pdf/content-code-examples/how-to/draw-line-and-rectangle-draw-rectangle.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Configure the required parameters
int pageIndex = 0;
var rectangle = new IronSoftware.Drawing.RectangleF(200, 100, 1000, 100);
var lineColor = new IronSoftware.Drawing.Color("#000000");
var fillColor = new IronSoftware.Drawing.Color("#32AB90");
int lineWidth = 5;

// Draw rectangle on PDF
pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth);

pdf.SaveAs("drawRectangle.pdf");
$vbLabelText   $csharpLabel

À quoi ressemble la sortie de dessin de rectangle ?

Créer des mises en page complexes avec des rectangles

Vous pouvez combiner des rectangles avec d'autres éléments de dessin pour créer des mises en page sophistiquées. Voici un exemple de création d'un modèle de carte de visite :

// Create a business card template
var cardBorder = new IronSoftware.Drawing.RectangleF(50, 50, 350, 200);
var logoArea = new IronSoftware.Drawing.RectangleF(60, 60, 80, 80);
var textArea = new IronSoftware.Drawing.RectangleF(150, 60, 240, 180);

// Draw the main card border
pdf.DrawRectangle(0, cardBorder, new IronSoftware.Drawing.Color("#000000"), 
                 new IronSoftware.Drawing.Color("#FFFFFF"), 3);

// Draw logo area with light gray background
pdf.DrawRectangle(0, logoArea, new IronSoftware.Drawing.Color("#666666"), 
                 new IronSoftware.Drawing.Color("#F0F0F0"), 1);

// Draw text area border
pdf.DrawRectangle(0, textArea, new IronSoftware.Drawing.Color("#CCCCCC"), 
                 null, 1); // null for no fill
// Create a business card template
var cardBorder = new IronSoftware.Drawing.RectangleF(50, 50, 350, 200);
var logoArea = new IronSoftware.Drawing.RectangleF(60, 60, 80, 80);
var textArea = new IronSoftware.Drawing.RectangleF(150, 60, 240, 180);

// Draw the main card border
pdf.DrawRectangle(0, cardBorder, new IronSoftware.Drawing.Color("#000000"), 
                 new IronSoftware.Drawing.Color("#FFFFFF"), 3);

// Draw logo area with light gray background
pdf.DrawRectangle(0, logoArea, new IronSoftware.Drawing.Color("#666666"), 
                 new IronSoftware.Drawing.Color("#F0F0F0"), 1);

// Draw text area border
pdf.DrawRectangle(0, textArea, new IronSoftware.Drawing.Color("#CCCCCC"), 
                 null, 1); // null for no fill
$vbLabelText   $csharpLabel

Meilleures pratiques et conseils

<TODO : Ajouter une image ici -->

Lorsque vous travaillez avec des lignes et des rectangles dans des PDF, tenez compte de ces bonnes pratiques :

Compréhension du système de coordonnées

Le système de coordonnées du PDF part du coin inférieur gauche de la page, le X augmentant vers la droite et le Y augmentant vers le haut. Cela diffère de nombreux systèmes de coordonnées basés sur l'écran. La compréhension de ces éléments est essentielle pour un positionnement précis. Pour plus de détails sur la mise en page, consultez notre guide sur les marges personnalisées.

Considérations de performance

Lorsque vous dessinez plusieurs formes, effectuez des opérations par lots dans la mesure du possible. Au lieu d'enregistrer le PDF après chaque forme, dessinez d'abord toutes les formes, puis enregistrez une seule fois. Cette approche est particulièrement importante lorsque l'on travaille avec des fichiers PDF volumineux.

Sélection de couleurs

Utilisez des schémas de couleurs cohérents dans l'ensemble de votre document. Tenez compte de l'accessibilité en garantissant un contraste suffisant entre les couleurs des lignes et des remplissages et l'arrière-plan. La bibliothèque IronDrawing prend en charge différents formats de couleurs, notamment les codes hexadécimaux, les valeurs RVB et les couleurs nommées.

Intégration avec d'autres fonctionnalités

Les opérations de dessin fonctionnent bien avec d'autres fonctionnalités d'IronPdf. Vous pouvez :

  • S'appuyer sur des PDF existants chargés à partir de fichiers
  • Ajouter des formes aux PDF générés à partir de HTML
  • Combiner le dessin avec le texte et l'estampage d'images
  • Utiliser le dessin avec les paramètres d'orientation de la page

Pour des exemples de ces intégrations, consultez nos guides sur la création de nouveaux PDF, l'estampillage d'une image de texte et la rotation de l'orientation de la page.

Gestion des erreurs

Mettez toujours en œuvre une gestion appropriée des erreurs lorsque vous dessinez sur des PDF :

try 
{
    pdf.DrawLine(pageIndex, start, end, width, color);
    pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth);
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    Console.WriteLine($"Error drawing on PDF: {ex.Message}");
    // Handle the error appropriately
}
try 
{
    pdf.DrawLine(pageIndex, start, end, width, color);
    pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth);
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    Console.WriteLine($"Error drawing on PDF: {ex.Message}");
    // Handle the error appropriately
}
$vbLabelText   $csharpLabel

Commencer

Pour commencer à utiliser les fonctionnalités de dessin d'IronPDF dans votre projet, suivez notre aperçu d'installation ou consultez le guide de démarrage rapide pour une introduction complète à IronPDF.

Pour des opérations de dessin plus avancées, notamment l'ajout de texte et de bitmaps à vos PDF, explorez notre guide sur le dessin de texte et de bitmaps. Ces fonctionnalités, combinées au dessin de lignes et de rectangles, constituent une boîte à outils complète pour la personnalisation et l'amélioration des PDF.

Questions Fréquemment Posées

Comment tracer une ligne sur un PDF à l'aide de C# ?

Pour dessiner une ligne sur un PDF en C#, utilisez la méthode DrawLine d'IronPDF sur un objet PdfDocument. Il suffit de spécifier les coordonnées de début et de fin, la couleur (sous forme de code hexadécimal) et la largeur de la ligne. Par exemple : pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2) crée une ligne horizontale rouge.

Quels sont les paramètres acceptés par la méthode DrawLine ?

La méthode DrawLine d'IronPDF accepte plusieurs paramètres : Index de la page (la page sur laquelle dessiner), Coordonnées du point de départ (X, Y), Coordonnées du point d'arrivée (X, Y), Largeur (épaisseur de la ligne en points), et Couleur (en utilisant des codes hexadécimaux ou des couleurs prédéfinies).

Puis-je ajouter des rectangles à des documents PDF existants ?

Oui, vous pouvez ajouter des rectangles à des PDF existants en utilisant la méthode DrawRectangle d'IronPDF. Cette méthode vous permet de spécifier la position du rectangle, ses dimensions, la couleur de la bordure, la couleur de remplissage et l'épaisseur de la bordure pour créer des formes personnalisées sur vos pages PDF.

Quels types de formes géométriques puis-je créer sur des PDF ?

Avec IronPDF, vous pouvez créer des lignes et des rectangles sur des documents PDF. Ces formes peuvent être utilisées pour créer des formulaires, des diagrammes, des annotations, des bordures, des séparateurs et pour mettre en évidence des sections importantes dans vos PDF.

Dois-je créer un nouveau PDF pour ajouter des formes ou puis-je modifier des PDF existants ?

IronPDF vous permet de modifier des PDF existants en y ajoutant des formes. Vous pouvez charger un PDF existant à l'aide de PdfDocument.FromFile(), puis utiliser les méthodes de dessin pour ajouter des lignes et des rectangles sans créer un nouveau document à partir de zéro.

Comment puis-je contrôler la couleur des formes dans mon PDF ?

IronPDF prend en charge la personnalisation des couleurs à l'aide de codes de couleur hexagonaux (comme "#FF0000" pour le rouge) ou de couleurs prédéfinies. La classe Color de l'API IronDrawing offre des options supplémentaires pour appliquer des couleurs à vos lignes et rectangles.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
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