如何使用 C# 在 PDF 上繪製文字與位圖</#35;

了解座標系統

繪製文字之前，請先瞭解 PDF 坐標系統。 原點 (0,0) 位於頁面左下角，X 值向右增加，Y 值向上增加。 這與許多圖形系統的原點在左上方不同。

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

我可以使用哪些字型？

DrawText 方法目前支援 IronPDF 中所有的 標準字型，包括 Courier, Arial (或 Helvetica), TimesNewRoman, Symbol, 和 ZapfDingbats. 請造訪"管理字體"文章中的" IronPDF 中的標準字體"部分，以了解這些字體類型的斜體、粗體和傾斜變體。

ZapfDingbats 字型可以顯示如 ▲ 等符號。 如需支援符號的完整清單，請造訪 Wikipedia on Zapf Dingbats。

在 PDF 上輸出字體範例

如何使用換行添加文字？

繪製文字操作支援換行符，可讓您使用內建換行符渲染文本，以獲得更好的格式和視覺清晰度。 這在新增多行註解或建立結構化文字佈局時非常有用。

要實現這一點，請在文字字串中新增newline characters (\n) 。 使用上面的範例：

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

如何使用自訂字型？

DrawText 方法支援自訂字型，讓您的排版選項超越標準字型。 在保持品牌一致性或使用專用字型時，此功能至關重要。 如需進階的字型管理，請參閱我們的 在 PDF 中管理字型的指南。

以下是一個範例，內文加入了 Pixelify Sans 字型：

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

進階文字定位

在精確定位文字時，請考慮以下提示：

• 頁面尺寸：使用 pdf.Pages[pageIndex].Width 和 pdf.Pages[pageIndex].Height 取得頁面尺寸
• 旋轉：旋轉參數可接受角度 (0-360)，適用於有角度的文字。
• 顏色選項：除了基本顏色之外，請使用 RGB 值：Color.FromArgb(255, 100, 100)

IronPDF 的 DrawBitmap 方法可讓您在現有的 PDF 文件中加入位圖。 此方法的功能類似於 Image Stamper 功能，可讓您在現有的 PDF 上標示圖片。 如需複雜的圖片處理需求，請參閱我們的 在 PDF 中加入圖片指南。

範例影像

實作是什麼樣子？

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

輸出 PDF

還有哪些其他參數可用？

• PixelFormat：PixelFormat屬性指定位圖的色彩資料格式，主要是控制透明度支援。 預設值為Format32bppArgb。 透過傳入參數作為選項，在像素枚舉格式 Format32bppRgb 和 Format32bppArgb 之間進行選擇。 這在處理 PDF 中的 背景和前景元素時非常有用。

• IgnorePageRotation：這個 bool 屬性決定繪圖位圖時，方法是否忽略頁面旋轉。預設值為 false。 特別是在所有頁面上一致地應用水印時，不論轉換方式如何，都會非常有用。

常見使用案例與最佳實務

在 PDF 上繪製文字和圖片時，請考慮這些實際應用：

1.動態水印：在敏感文件上加入公司標誌或"CONFIDENTIAL"戳記 2.頁面編號：在所有頁面上以一致的位置繪製頁碼 3.簽名位置：在表單的指定位置新增簽名影像 4.標題/頁腳增強：以動態內容補足現有的標題

為了除錯和監控 PDF 作業，請執行 自訂記錄 以追蹤繪圖作業並確保正確執行。

效能考量

在處理多頁或大型文件時：

• 盡可能進行批次作業，以盡量減少記憶體使用量
• 使用後棄置位圖物件以釋放資源
• 考慮預先載入常用的圖片以改善效能

準備好看看您還能做些什麼嗎？ 在此查看我們的教學頁面： 編輯 PDFs