Text und Bitmap in PDFs mit C# zeichnen

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

Welche Schriftarten kann ich verwenden?

Die Methode DrawText unterstützt derzeit alle Standard-Schriftarten 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

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 newline characters (\n) zur Textzeichenfolge 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);

Wie verwende ich benutzerdefinierte Schriftarten?

Mit der Methode DrawText werden benutzerdefinierte Schriftarten unterstützt, wodurch sich Ihre typografischen Optionen über Standardschriftarten hinaus erweitern. 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");

Erweiterte Textpositionierung

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

• Seitenabmessungen : Verwenden Sie pdf.Pages[pageIndex].Width und pdf.Pages[pageIndex].Height, um die Seitenabmessungen zu erhalten.
• Drehung: Der Parameter Drehung akzeptiert Gradzahlen (0-360) für angewinkelten Text
• Farboptionen : Neben den Grundfarben können RGB-Werte verwendet werden: Color.FromArgb(255, 100, 100)

Mit der Methode DrawBitmap 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.

Beispielbild

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

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 Transparenzunterstützung. 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 Eigenschaft (bool) legt fest, 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