Wie zeichnet man Linien und Rechtecke auf PDFs in C#

Linien und Rechtecke in PDFs zeichnen in C#35;

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

Um in C# Linien und Rechtecke in PDFs zu zeichnen, verwenden Sie die Methoden DrawLine und DrawRectangle von IronPDF für ein PdfDocument-Objekt und geben Koordinaten, Farben und Abmessungen an, um professionelle geometrische Formen programmatisch hinzuzufügen.

Das Zeichnen von Linien und Rechtecken in ein PDF-Dokument bezieht sich auf den Prozess, geometrische Formen, insbesondere Linien und Rechtecke, zum Inhalt einer PDF-Datei hinzuzufügen. Dies geschieht oft programmatisch unter Verwendung einer Programmiersprache wie C# oder VB.NET und einer Bibliothek wie IronPDF.

Wenn Sie eine Linie zeichnen, erstellen Sie ein sichtbares Liniensegment mit festgelegten Start- und Endpunkten. Ähnlich definieren Sie beim Zeichnen eines Rechtecks eine viereckige Form mit angegebenen Abmessungen und Positionen. Diese Zeichenfunktionen sind für die Erstellung von Formularen, Diagrammen, Anmerkungen und die Hervorhebung wichtiger Abschnitte in PDF-Dokumenten unerlässlich. Die Zeichenfunktionen von IronPDF lassen sich nahtlos in die anderen PDF-Bearbeitungsfunktionen integrieren, so dass Entwickler bestehende PDFs verbessern oder völlig neue Dokumente mit benutzerdefinierten Grafiken erstellen können.

Schnellstart: Linien und Rechtecke mit IronPDF zeichnen

Fügen Sie mit IronPDF Linien und Rechtecke zu Ihren PDF-Dokumenten hinzu. Diese Anleitung zeigt, wie man die Methode DrawLine für Linien und die Methode DrawRectangle für Rechtecke verwendet. Mit nur wenigen Codezeilen können Sie dynamische grafische Elemente in Ihren PDFs erstellen und Ihre Anwendungen mit professionellen Grafiken versehen.

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    IronPdf.PdfDocument pdf = IronPdf.PdfDocument.FromFile("input.pdf");
    pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2);
    pdf.SaveAs("output.pdf");
  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronPDF in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer


Wie zeichne ich Linien auf PDFs in C#35?

Mit der Methode DrawLine, die für das PdfDocument-Objekt zur Verfügung steht, können Sie einem vorhandenen PDF-Dokument Zeilen hinzufügen. Die Verwendung der Color-Klasse, die von IronDrawing API Documentation angeboten wird, eröffnet die Möglichkeit, eine Linie mit einer Farbe aus einem HEX-Farbcode zu versehen. Mit dieser Funktion können Sie Unterstreichungen, Trennlinien, Rahmen oder benutzerdefinierte Diagramme direkt in Ihren PDF-Dokumenten erstellen.

Die Methode DrawLine akzeptiert mehrere Parameter, mit denen Sie das Aussehen Ihrer Linien genau steuern können:

  • Seitenindex: Gibt an, auf welcher Seite gezeichnet werden soll (nullbasierte Indizierung)
  • Startpunkt: Die Anfangskoordinaten (X, Y)
  • Endpunkt: Die Endkoordinaten (X, Y)
  • Breite: Die Dicke in Punkten
  • Farbe: Die Zeilenfarbe unter Verwendung von Hex-Codes oder vordefinierten Farben
: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

Weitere fortgeschrittene Funktionen zur PDF-Bearbeitung finden Sie in der API-Referenz, die eine umfassende Dokumentation für alle verfügbaren Methoden und Eigenschaften enthält.

Wie sieht die Ausgabe der Strichzeichnung aus?

Fortgeschrittene Techniken des Linienzeichnens

Wenn Sie mit Linien in PDFs arbeiten, möchten Sie vielleicht komplexere Muster oder Designs erstellen. Hier ist ein Beispiel für das Zeichnen mehrerer Linien, um ein Gittermuster zu erstellen:

// 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

Diese Technik ist besonders nützlich, wenn Sie Formulare oder strukturierte Layouts in Ihren PDFs erstellen. Weitere Informationen zur Erstellung von Formularen finden Sie in unserem Leitfaden zur Erstellung von PDF-Formularen.

Wie zeichne ich Rechtecke auf PDFs in C#35?

Um Rechtecke zu PDFs hinzuzufügen, verwenden Sie die DrawRectangle-Methode. Sobald das PDF-Dokument geöffnet oder gerendert ist, ist diese Methode für das PdfDocument-Objekt verfügbar. Konfigurieren Sie die Koordinaten, Breite und Höhe für das Rechteck mit der Klasse RectangleF, die von IronDrawing API Documentation angeboten wird.

Rechtecke sind vielseitige Formen, die in PDF-Dokumenten für verschiedene Zwecke verwendet werden können:

  • Rahmen um wichtige Inhalte schaffen
  • Hervorhebung von Textabschnitten oder Bildern
  • Erstellen von Formularfeldern und Kontrollkästchen
  • Gestaltung von Kopf- und Fußzeilen
  • Erstellen visueller Trennlinien zwischen Abschnitten

Die Methode DrawRectangle bietet Optionen für Umriss- und Füllfarben, mit denen Sie entweder umrissene Rechtecke, gefüllte Rechtecke oder eine Kombination aus beidem erstellen können. Diese Flexibilität macht es ideal für Benutzerdefinierte Wasserzeichen und andere visuelle Erweiterungen.

: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

Wie sieht die Ausgabe für das Zeichnen von Rechtecken aus?

Komplexe Layouts mit Rechtecken erstellen

Sie können Rechtecke mit anderen Zeichenfunktionen kombinieren, um anspruchsvolle Layouts zu erstellen. Hier ist ein Beispiel, das eine Visitenkartenvorlage erstellt:

// 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

Beste Praktiken und Tipps

Beachten Sie bei der Arbeit mit Linien und Rechtecken in PDF-Dateien die folgenden bewährten Verfahren:

Koordinatensystem-Verständnis

Das PDF-Koordinatensystem beginnt in der linken unteren Ecke der Seite, wobei X nach rechts und Y nach oben ansteigt. Dies unterscheidet sich von vielen bildschirmbasierten Koordinatensystemen. Dies zu verstehen ist entscheidend für eine genaue Positionierung. Weitere Einzelheiten zum Seitenlayout finden Sie in unserem Leitfaden zu angepassten Seitenrändern.

Erwägungen zur Leistung

Wenn Sie mehrere Formen zeichnen, sollten Sie, wann immer möglich, Stapeloperationen durchführen. Anstatt die PDF-Datei nach jeder Form zu speichern, sollten Sie alle Formen zuerst zeichnen und dann einmal speichern. Dieser Ansatz ist besonders wichtig bei der Arbeit mit großen PDF-Dateien.

Farbauswahl

Verwenden Sie im gesamten Dokument ein einheitliches Farbschema. Berücksichtigen Sie die Barrierefreiheit, indem Sie für einen ausreichenden Kontrast zwischen Linien-/Füllfarben und dem Hintergrund sorgen. Die IronDrawing-Bibliothek unterstützt verschiedene Farbformate, darunter Hex-Codes, RGB-Werte und benannte Farben.

Integration mit anderen Funktionen

Zeichnungsvorgänge funktionieren gut mit anderen IronPDF-Funktionen. Das können Sie:

  • Auf bestehende, aus Dateien geladene PDFs zurückgreifen
  • Hinzufügen von Formen zu aus HTML generierten PDFs
  • Kombinieren Sie Zeichnungen mit Text und Bildstempeln
  • Zeichnung mit Seitenorientierungseinstellungen verwenden

Beispiele für diese Integrationen finden Sie in unseren Anleitungen zu Erstellung neuer PDFs, Textbild stempeln und Seitenausrichtung drehen.

Fehlerbehandlung

Achten Sie beim Zeichnen von PDFs auf eine angemessene Fehlerbehandlung:

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

Einstieg

Um die Zeichenfunktionen von IronPDF in Ihrem Projekt zu nutzen, folgen Sie unserer Installationsübersicht oder lesen Sie die Schnellstartanleitung für eine umfassende Einführung in IronPDF.

Für fortgeschrittene Zeichenoperationen, einschließlich des Hinzufügens von Text und Bitmaps zu Ihren PDFs, lesen Sie unseren Leitfaden zum Zeichnen von Text und Bitmaps. Diese Funktionen, kombiniert mit dem Zeichnen von Linien und Rechtecken, bieten ein komplettes Toolkit für die Anpassung und Verbesserung von PDF-Dateien.

Häufig gestellte Fragen

Wie zeichne ich mit C# eine Linie in einer PDF-Datei?

Um in C# eine Linie in einer PDF-Datei zu zeichnen, verwenden Sie die DrawLine-Methode von IronPDF für ein PdfDocument-Objekt. Geben Sie einfach die Start- und Endkoordinaten, die Farbe (als Hex-Code) und die Linienbreite an. Zum Beispiel: pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2) erzeugt eine rote horizontale Linie.

Welche Parameter akzeptiert die Methode DrawLine?

Die DrawLine-Methode von IronPDF akzeptiert mehrere Parameter: Seitenindex (auf welcher Seite gezeichnet werden soll), Startpunktkoordinaten (X, Y), Endpunktkoordinaten (X, Y), Breite (Liniendicke in Punkten) und Farbe (unter Verwendung von Hex-Codes oder vordefinierten Farben).

Kann ich Rechtecke in bestehende PDF-Dokumente einfügen?

Ja, mit der DrawRectangle-Methode von IronPDF können Sie Rechtecke in bestehende PDF-Dateien einfügen. Mit dieser Methode können Sie die Position, die Abmessungen, die Farbe des Rahmens, die Füllfarbe und die Dicke des Rahmens des Rechtecks festlegen, um benutzerdefinierte Formen auf Ihren PDF-Seiten zu erstellen.

Welche Arten von geometrischen Formen kann ich in PDFs erstellen?

Mit IronPDF können Sie Linien und Rechtecke in PDF-Dokumenten erstellen. Diese Formen können zur Erstellung von Formularen, Diagrammen, Anmerkungen, Rahmen, Trennlinien und zur Hervorhebung wichtiger Abschnitte in Ihren PDFs verwendet werden.

Muss ich eine neue PDF-Datei erstellen, um Formen hinzuzufügen, oder kann ich bestehende ändern?

IronPDF ermöglicht es Ihnen, bestehende PDFs durch Hinzufügen von Formen zu verändern. Sie können ein bestehendes PDF mit PdfDocument.FromFile() laden und dann die Zeichenmethoden verwenden, um Linien und Rechtecke hinzuzufügen, ohne ein neues Dokument von Grund auf zu erstellen.

Wie kann ich die Farbe von Formen in meiner PDF-Datei steuern?

IronPDF unterstützt die Farbanpassung mithilfe von Hex-Farbcodes (wie "#FF0000" für Rot) oder vordefinierten Farben. Die Klasse Color aus der IronDrawing-API bietet zusätzliche Optionen für die Anwendung von Farben auf Ihre Linien und Rechtecke.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 17,012,929 | Version: 2025.12 gerade veröffentlicht