1. IronPDF
  2. Anleitungen
  3. Text & Bitmap zeichnen
Wie man Text und Bitmap auf PDFs in C# zeichnet

Text und Bitmap in PDFs mit C#35 zeichnen

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

IronPDF ermöglicht es, mit den Methoden DrawText und DrawBitmap Text und Bilder auf bestehende PDFs zu zeichnen. Dies ermöglicht die Anpassung mit Wasserzeichen, Logos, Anmerkungen und verbesserter visueller Darstellung, ohne den ursprünglichen Inhalt zu verändern.

Beim Zeichnen von Text und Bildern in einer PDF-Datei werden Inhalte zu einem bestehenden Dokument hinzugefügt. IronPDF ermöglicht diese Funktion nahtlos. Durch die Einbindung von Text und Bildern können Sie PDFs mit Wasserzeichen, Logos und Anmerkungen versehen und so das visuelle Erscheinungsbild des Dokuments und das Branding verbessern. Außerdem erleichtern Text und Bilder die Präsentation von Informationen, die Visualisierung von Daten und die Erstellung interaktiver Formulare.

als-Überschrift:2(Schnellstart: Hinzufügen von Text und Bildern zu PDFs mit IronPDF)

Erweitern Sie Ihre PDF-Dokumente schnell und effizient mit Text und Bildern. Mit den Methoden DrawText und DrawBitmap können Sie PDFs leicht anpassen, indem Sie Wasserzeichen, Logos oder Anmerkungen hinzufügen. Dieses Beispiel zeigt, wie Sie Text an bestimmten Koordinaten zeichnen und ein Bild nahtlos in Ihre PDF-Datei einfügen können.

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.

    new ChromePdfRenderer()
    .RenderHtmlAsPdf("<h1>Doc</h1>")
    .DrawText("Hello World", FontTypes.TimesNewRoman.Name, 12, 0, 100, 100, Color.Black, 0)
    .DrawBitmap(AnyBitmap.FromFile("logo.png"), 0, 50, 250, 500, 300)
    .SaveAs("annotated.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

Minimaler Arbeitsablauf (5 Schritte)

  1. Herunterladen der C#-Bibliothek für IronPDF zum Zeichnen von Text und Bildern auf PDFs
  2. Das Ziel-PDF-Dokument importieren
  3. Verwenden Sie die Methode DrawText, um der importierten PDF-Datei Text in der gewünschten Schriftart hinzuzufügen
  4. Mit der Methode DrawBitmap ein Bild in die PDF-Datei einfügen
  5. Exportieren Sie das bearbeitete PDF-Dokument


Wie zeichne ich Text in eine PDF-Datei?

Mit der DrawText-Methode des PdfDocument-Objekts können Sie Text in ein bestehendes PDF-Dokument einfügen, ohne dessen ursprünglichen Inhalt zu verändern. Diese Methode ist besonders nützlich für das Hinzufügen dynamischer Inhalte zu PDFs, ähnlich wie die Funktion Stempeln von Text und Bild für komplexere Überlagerungen.

Verständnis des Koordinatensystems

Bevor Sie den Text zeichnen, sollten Sie das PDF-Koordinatensystem verstehen. Der Ursprung (0,0) befindet sich in der unteren linken Ecke der Seite, wobei die X-Werte nach rechts und die Y-Werte nach oben hin zunehmen. Dies unterscheidet sich von vielen Grafiksystemen, bei denen der Ursprung oben links liegt.

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-text.cs
using IronPdf;
using IronSoftware.Drawing;

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

// Draw text on PDF
pdf.DrawText("Some text", FontTypes.TimesNewRoman.Name, FontSize: 12, PageIndex: 0, X: 100, Y: 100, Color.Black, Rotation: 0);

pdf.SaveAs("drawText.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Welche Schriftarten kann ich verwenden?

Die Methode DrawText unterstützt derzeit alle Standardschriften in IronPDF, einschließlich Courier, Arial (oder Helvetica), TimesNewRoman, Symbol, und ZapfDingbats. Besuchen Sie den Abschnitt 'Standard-Schriftarten in IronPDF' im Artikel Schriftarten verwalten für kursive, fettgedruckte und schräge Varianten dieser Schriftarten.

Die Schriftart ZapfDingbats kann Symbole wie ▲ darstellen. Eine umfassende Liste der unterstützten Symbole finden Sie auf Wikipedia on Zapf Dingbats.

Beispiel von Ausgabeschriften auf PDF

Schriftmuster der Familien Arial, Courier, Helvetica und Times New Roman mit fetten, kursiven und schrägen Varianten

Wie kann ich Text mit Zeilenumbrüchen hinzufügen?

Die Textzeichnungsaktion unterstützt Zeilenumbruchszeichen, wodurch Sie Text mit eingebauten Zeilenumbrüchen für eine bessere Formatierung und visuelle Klarheit darstellen können. Dies ist nützlich, wenn mehrzeilige Anmerkungen hinzugefügt oder strukturierte Textlayouts erstellt werden.

Um dies zu erreichen, fügen Sie Zeilenumbruchszeichen (\n) zum Textstring hinzu. Nehmen wir das obige Beispiel:

// Multi-line text example with proper spacing
string textWithNewlines = "Some text\nSecond line\nThird line with more content";
pdfDoc.DrawText(textWithNewlines, font, position);

// You can also use Environment.NewLine for platform-specific line breaks
string platformText = $"Line 1{Environment.NewLine}Line 2{Environment.NewLine}Line 3";
pdfDoc.DrawText(platformText, font, position);
// Multi-line text example with proper spacing
string textWithNewlines = "Some text\nSecond line\nThird line with more content";
pdfDoc.DrawText(textWithNewlines, font, position);

// You can also use Environment.NewLine for platform-specific line breaks
string platformText = $"Line 1{Environment.NewLine}Line 2{Environment.NewLine}Line 3";
pdfDoc.DrawText(platformText, font, position);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Wie verwende ich benutzerdefinierte Schriftarten?

Benutzerdefinierte Schriftarten werden mit der DrawText-Methode unterstützt, wodurch die Typografieoptionen über die Standardschriftarten hinaus erweitert werden. Diese Funktion ist wichtig, um die Markenkonsistenz zu wahren oder mit speziellen Schriftarten zu arbeiten. Für fortgeschrittene Schriftartenverwaltung siehe unseren Leitfaden zur Verwaltung von Schriftarten in PDFs.

Nachfolgend finden Sie ein Beispiel mit der Schriftart Pixelify Sans, die dem Text hinzugefügt wurde:

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-custom-font.cs
using IronPdf;
using IronSoftware.Drawing;
using System.IO;

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

// Add custom font to the PDF
byte[] fontByte = File.ReadAllBytes(@".\PixelifySans-VariableFont_wght.ttf");
var addedFont = pdf.Fonts.Add(fontByte);

// Draw text on PDF
pdf.DrawText("Iron Software", addedFont.Name, FontSize: 12, PageIndex: 0, X: 100, Y: 600, Color.Black, Rotation: 0);

pdf.SaveAs("drawCustomFont.pdf");
Imports IronPdf
Imports IronSoftware.Drawing
Imports System.IO

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Add custom font to the PDF
Private fontByte() As Byte = File.ReadAllBytes(".\PixelifySans-VariableFont_wght.ttf")
Private addedFont = pdf.Fonts.Add(fontByte)

' Draw text on PDF
pdf.DrawText("Iron Software", addedFont.Name, FontSize:= 12, PageIndex:= 0, X:= 100, Y:= 600, Color.Black, Rotation:= 0)

pdf.SaveAs("drawCustomFont.pdf")
$vbLabelText   $csharpLabel

Erweiterte Textpositionierung

Beachten Sie bei der genauen Positionierung des Textes die folgenden Tipps:

  • Seitenmaße: Verwenden Sie pdf.Pages[pageIndex].Width und pdf.Pages[pageIndex].Height, um die Seitenabmessungen zu ermitteln
  • Drehung: Der Parameter Drehung akzeptiert Gradzahlen (0-360) für angewinkelten Text
  • Farboptionen: Über die Grundfarben hinaus, verwenden Sie RGB-Werte: Color.FromArgb(255, 100, 100)

Wie zeichne ich Bilder in PDF-Dateien?

Mit der DrawBitmap-Methode von IronPDF können Sie Bitmaps zu bestehenden PDF-Dokumenten hinzufügen. Diese Methode funktioniert ähnlich wie die Image Stamper-Funktion, mit der Sie Bilder in vorhandene PDFs stempeln können. Wenn Sie komplexe Bildbearbeitungen benötigen, lesen Sie unseren Leitfaden zum Hinzufügen von Bildern zu PDFs.

Hinweis:Die Methode DrawBitmap funktioniert am besten mit großen Bildern. Bei der Verwendung von Bildern mit geringerer Auflösung kann die folgende Ausnahme auftreten: IronPdf.Exceptions.IronPdfNativeException: 'Fehler beim Zeichnen des Bildes: Datenlänge (567000) ist kleiner als erwartet (756000)'. Um dieses Problem zu beheben, verwenden Sie den Image Stamper, der Bilder aller Größen verarbeitet.

Beispielbild

Iron Software-Logo mit farbenfrohem, ineinandergreifendem geometrischem 3D-Design auf Markenhintergrund

Wie sieht die Implementierung aus?

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-bitmap.cs
using IronPdf;
using IronSoftware.Drawing;

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

// Open the image from file
AnyBitmap bitmap = AnyBitmap.FromFile("ironSoftware.png");

// Draw the bitmp on PDF
pdf.DrawBitmap(bitmap, 0, 50, 250, 500, 300);

pdf.SaveAs("drawImage.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Ausgangs-PDF

Welche zusätzlichen Parameter sind verfügbar?

  • PixelFormat: Die Eigenschaft PixelFormat legt das Farbdatenformat für die Bitmap fest und steuert in erster Linie die Unterstützung von Transparenz. Der Standardwert ist Format32bppArgb. Wählen Sie zwischen den Pixel-Enum-Formaten Format32bppRgb und Format32bppArgb, indem Sie den Parameter als Option übergeben. Dies ist nützlich bei der Arbeit mit Hintergrund- und Vordergrundelementen in PDFs.

  • IgnorePageRotation: Diese bool Eigenschaft bestimmt, ob die Methode die Seitendrehung beim Zeichnen der Bitmap ignoriert. Standardmäßig ist der Wert false. Besonders nützlich, wenn Wasserzeichen konsistent auf alle Seiten angewendet werden, unabhängig von der Rotation.

Gängige Anwendungsfälle und bewährte Praktiken

Beachten Sie beim Zeichnen von Text und Bildern in PDFs diese praktischen Anwendungen:

  1. Dynamisches Wasserzeichen: Hinzufügen von Firmenlogos oder "CONFIDENTIAL"-Stempeln zu vertraulichen Dokumenten
  2. Seitennummerierung: Zeichnen Sie Seitenzahlen an einheitlichen Positionen auf allen Seiten
  3. Unterschriftenplatzierung: Hinzufügen von Unterschriftsbildern an bestimmten Stellen in Formularen
  4. Kopf-/Fußzeilenverbesserung: Ergänzen Sie bestehende Kopfzeilen mit dynamischen Inhalten

Zum Debuggen und Überwachen von PDF-Vorgängen implementieren Sie angepasstes Logging, um Zeichenvorgänge zu verfolgen und die korrekte Ausführung sicherzustellen.

Erwägungen zur Leistung

Bei der Arbeit mit mehreren Seiten oder großen Dokumenten:

  • Batch-Operationen, wenn möglich, um die Speichernutzung zu minimieren
  • Bitmap-Objekte nach Gebrauch entsorgen, um Ressourcen freizugeben
  • Erwägen Sie das Vorladen häufig verwendeter Bilder, um die Leistung zu verbessern

Bereit zu sehen, was Sie sonst noch tun können? Besuchen Sie unsere Tutorialseite hier: PDFs bearbeiten

Häufig gestellte Fragen

Welche Methoden kann ich verwenden, um Text und Bilder in bestehende PDF-Dateien einzufügen?

IronPDF bietet zwei Hauptmethoden zum Hinzufügen von Inhalten zu bestehenden PDFs: die DrawText-Methode zum Hinzufügen von Text und die DrawBitmap-Methode zum Hinzufügen von Bildern. Mit diesen Methoden können Sie PDFs mit Wasserzeichen, Logos und Anmerkungen versehen, ohne den ursprünglichen Dokumentinhalt zu verändern.

Wie funktioniert das PDF-Koordinatensystem beim Zeichnen von Text?

In IronPDF hat das PDF-Koordinatensystem seinen Ursprung (0,0) in der unteren linken Ecke der Seite. Die X-Werte nehmen nach rechts hin zu und die Y-Werte nach oben hin. Dies unterscheidet sich von vielen Grafiksystemen, bei denen der Ursprung in der linken oberen Ecke liegt.

Welche Schriftarten werden beim Zeichnen von Text in PDFs unterstützt?

Die DrawText-Methode von IronPDF unterstützt alle Standard-Schriftarten, einschließlich Courier, Arial (Helvetica), Times New Roman, Symbol und ZapfDingbats. Diese Schriften sind auch in kursiven, fetten und schrägen Varianten verfügbar. Die Schriftart ZapfDingbats kann zur Darstellung spezieller Symbole verwendet werden.

Kann ich einer PDF-Datei in einem einzigen Arbeitsgang sowohl Text als auch Bilder hinzufügen?

Ja, IronPDF erlaubt es Ihnen, Methoden miteinander zu verketten. Sie können ChromePdfRenderer verwenden, um eine PDF-Datei zu erstellen, und dann die Methoden DrawText und DrawBitmap nacheinander in einer einzigen Codezeile anwenden, was das Hinzufügen mehrerer Elemente zu Ihrem PDF-Dokument effizient macht.

Was sind die häufigsten Anwendungsfälle für das Zeichnen von Text und Bildern in PDFs?

Die Zeichenfunktionen von IronPDF werden häufig zum Hinzufügen von Wasserzeichen zum Schutz von Dokumenten, zum Einfügen von Firmenlogos für das Branding, zum Erstellen von Anmerkungen für die Überprüfung von Dokumenten, zur Verbesserung des visuellen Erscheinungsbildes, zur Erleichterung der Datenvisualisierung und zur Erstellung interaktiver Formulare verwendet.

Chaknith Bin
Chaknith Bin
  Jetzt mit dem Ingenieurteam chatten
Software Ingenieur
Chaknith arbeitet an IronXL und IronBarcode. Er hat umfassende Expertise in C# und .NET und hilft, die Software zu verbessern und Kunden zu unterstützen. Seine Einblicke aus Benutzerinteraktionen tragen zu besseren Produkten, Dokumentationen und einem insgesamt besseren Erlebnis bei.
Bereit anzufangen?
Nuget Downloads 16,685,821 | Version: 2025.12 gerade veröffentlicht