1. IronPDF
  2. 操作指南
  3. 繪製文字與位圖
如何在 C# 中於 PDF 上繪製文字與位圖

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

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

IronPDF 讓您能透過 DrawText 和 DrawBitmap 方法，在現有 PDF 上繪製文字與圖像，讓您在不改變原始內容的前提下，透過浮水印、標誌、註解等進行客製化，並提升視覺效果。

在 PDF 上繪製文字和圖片，是指將內容新增至現有文件中。 IronPDF 可無縫實現此功能。 透過整合文字與圖片，您可以自訂 PDF 文件中的浮水印、標誌和註解，從而提升文件的視覺效果與品牌形象。 此外，文字與圖片有助於資訊呈現、資料視覺化及互動式表單的建立。

快速入門：使用 IronPDF 向 PDF 文件添加文字與圖片

立即開始快速且高效地為您的 PDF 文件添加文字與圖片。 透過 DrawText 和 DrawBitmap 方法，您可以輕鬆地透過添加浮水印、標誌或註解來自訂 PDF 檔案。 此範例示範如何在特定座標繪製文字，並將圖片無縫嵌入您的 PDF 文件中。

  1. using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf

  2. 請複製並執行此程式碼片段。

    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. 部署至您的生產環境進行測試

    立即透過免費試用，在您的專案中開始使用 IronPDF

    arrow pointer

簡化工作流程（5 個步驟）

  1. 下載 IronPDF 的 C# 函式庫，用於在 PDF 上繪製文字和圖片
  2. 匯入目標 PDF 文件
  3. 請使用 DrawText 方法，將指定字體的文字加入已匯入的 PDF 檔案中
  4. 使用PDF工具添加图像 DrawBitmap 方法
  5. 匯出已編輯的 PDF 文件


如何在 PDF 上繪製文字？

DrawText 物件提供的 PdfDocument 方法，可讓您在不變更原始內容的情況下，向現有 PDF 文件中添加文字。 此方法特別適用於向 PDF 文件中添加動態內容，類似於用於更複雜疊加層的"蓋章文字與圖片"功能。

理解座標系統

在繪製文字之前，請先了解 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");
Imports IronPdf
Imports IronSoftware.Drawing

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = 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")
$vbLabelText   $csharpLabel

我可以使用哪些字型？

DrawText 方法目前支援 IronPDF 中的所有標準字型，包括 Arial（或 Symbol 以及 ZapfDingbats。 請參閱《管理字型》文章中的"IronPDF 標準字型"章節，以了解這些字型類型的斜體、粗體及斜體變體。

ZapfDingbats 字型可顯示 ▲ 等符號。 如需支援符號的完整清單，請參閱維基百科的 Zapf Dingbats 條目。

PDF 字型輸出範例

字型範例展示 Arial、Courier、Helvetica 及 Times New Roman 字型家族，包含粗體、斜體及斜體變體

如何在文字中加入換行？

"繪製文字"動作支援換行字元，讓您能以內建換行方式呈現文字，以獲得更好的格式與視覺清晰度。 這在添加多行註解或建立結構化文字版面時非常實用。

為達成此目標，請在文字字串中加入 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);
' Multi-line text example with proper spacing
Dim textWithNewlines As String = "Some text" & vbLf & "Second line" & vbLf & "Third line with more content"
pdfDoc.DrawText(textWithNewlines, font, position)

' You can also use Environment.NewLine for platform-specific line breaks
Dim platformText As String = $"Line 1{Environment.NewLine}Line 2{Environment.NewLine}Line 3"
pdfDoc.DrawText(platformText, font, position)
$vbLabelText   $csharpLabel

如何使用自訂字型？

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

進階文字定位

在精準定位文字時，請參考以下建議：

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

如何在 PDF 上繪製圖像？

IronPDF 的 DrawBitmap 方法可讓您將位圖新增至現有的 PDF 文件中。 此方法的功能類似於"圖片加蓋"功能，可讓您將圖片加蓋至現有的 PDF 檔案上。 若需處理複雜的影像操作需求，請參閱我們關於將影像加入 PDF 的指南。

請注意DrawBitmap 方法最適用於大型圖片。 當使用較低解析度的圖片時，您可能會遇到以下例外狀況：IronPdf.Exceptions.IronPdfNativeException：'繪製圖片時發生錯誤：資料長度 (567000) 低於預期 (756000)'。為解決此問題，請使用 Image Stamper，該工具可處理所有尺寸的圖片。

範例圖片

Iron Software 標誌，採用色彩繽紛的 3D 交錯幾何圖案設計，背景為品牌專屬色

實際實作效果為何？

: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");
Imports IronPdf
Imports IronSoftware.Drawing

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

' Open the image from file
Dim bitmap As AnyBitmap = AnyBitmap.FromFile("ironSoftware.png")

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

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

輸出 PDF

有哪些可用的附加參數？

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

  • IgnorePageRotation：此 bool 屬性決定方法在繪製位圖時是否忽略頁面旋轉。預設值為 false。 特別適用於需在所有頁面一致地套用浮水印的情境，無論頁面是否旋轉。

常見使用情境與最佳實務

在 PDF 上繪製文字和圖片時，請考慮以下實用應用：

  1. 動態浮水印：在敏感文件中加入公司標誌或"機密"印章
  2. 頁碼編排：請在所有頁面上以一致的位置標示頁碼
  3. 簽名位置：在表單的指定位置添加簽名圖片
  4. 頁首/頁尾強化：透過動態內容補充現有頁首

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

效能考量

處理多頁或大型文件時：

  • 盡可能進行批次操作以減少記憶體使用量
  • 使用完畢後請釋放位圖物件以釋放資源
  • 考慮預載常用圖片以提升效能

準備好探索更多可能性了嗎？ 請點此查看我們的教學頁面：編輯 PDF

常見問題

有哪些方法可以將文字和圖片加入現有的 PDF 檔案中？

IronPDF 提供兩種主要方法，用於向現有 PDF 文件中添加內容：DrawText 方法用於添加文字，DrawBitmap 方法用於添加圖片。透過這些方法，您可以在不改變原始文件內容的前提下，自訂 PDF 文件中的浮水印、標誌及註解。

在繪製文字時，PDF 座標系統是如何運作的？

在 IronPDF 中，PDF 座標系的原點 (0,0) 位於頁面的左下角。X 值向右增加，Y 值向上增加。這與許多以左上角為原點的圖形系統不同。

在 PDF 上繪製文字時，支援哪些字型？

IronPDF 的 DrawText 方法支援所有標準字型，包括 Courier、Arial (Helvetica)、Times New Roman、Symbol 及 ZapfDingbats。這些字型亦提供斜體、粗體及斜體變體。ZapfDingbats 字型可用於顯示特殊符號。

我能否透過單一操作同時將文字和圖片加入 PDF 檔案中？

是的，IronPDF 允許您串接方法。您可以使用 ChromePdfRenderer 建立 PDF 檔案，接著在單行程式碼中依序套用 DrawText 和 DrawBitmap 方法，如此一來便能高效地在 PDF 文件中加入多個元素。

在 PDF 上繪製文字和圖片有哪些常見的應用情境？

IronPDF 的繪圖功能常被用於添加浮水印以保護文件、插入公司標誌以建立品牌形象、建立註解以利文件審閱、提升視覺效果、促進資料視覺化，以及建立互動式表單。

Curtis Chau
Curtis Chau
  立即與工程團隊聯繫
技術撰稿人

Curtis Chau 擁有卡爾頓大學（Carleton University）的電腦科學學士學位，專精於前端開發，並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面，喜歡運用現代框架，並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外，Curtis 對物聯網（IoT）抱有濃厚興趣，致力於探索整合硬體與軟體的創新方法。閒暇時，他喜歡玩遊戲和開發 Discord 機器人，將對科技的熱愛與創意相結合。

準備開始了嗎？
Nuget 下載 19,014,616 | 版本： 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎？

想要快速確認成果嗎？ PM > Install-Package IronPdf
執行範例 觀看您的 HTML 轉為 PDF。