使用 C# 和 IronPDF 在 PDF 上新增文字和圖像印章

IronPDF 使用 TextStamper, ImageStamper, HTMLStamper, 和 BarcodeStamper 類別在 C# 中以精確的定位控制將文字、圖片、HTML 內容和條碼戳印到現有的 PDF 文件上。

<！--說明：說明程式碼概念的圖表或截圖 -->

Stamping 將額外的內容覆蓋在現有的 PDF 文件上。 圖章可在 PDF 上加入資訊、標籤、水印或註解。 使用圖章來加入頁首和頁尾，或利用 IronPDF 的全面圖章功能來建立自訂水印。

IronPDF 提供四種戳記器：TextStamper、ImageStamper、HTMLStamper和BarcodeStamper。 HTMLStamper 利用所有 HTML 功能與 CSS 定型，類似於 將 HTML 字串轉換為 PDF。

快速入門：立即在 PDF 上新增圖章文字

使用 IronPDF 的 TextStamper 類來新增文字註解、水印或標籤到 PDF 文件。 下面的示例演示了使用 ApplyStamp 方法在 PDF 上蓋印文字。

如何在 PDF 上標示文字？ <！--說明：說明程式碼概念的圖表或截圖 --> 建立一個包含所有顯示配置的 `TextStamper` 物件。 將 `TextStamper` 物件傳給 `ApplyStamp` 方法。 `Text` 屬性會設定顯示的文字。 設定字型族、字型樣式和圖章位置。 `TextStamper` 提供廣泛的自訂選項，類似於 PDF 文件中的 [ 管理字型](https://ironpdf.com/how-to/manage-fonts/)。 將 `UseGoogleFont` 設定為 true，即可使用系統字型或 Google 字型。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-text.cs ```

輸出的 PDF 是什麼樣子？

如何建立多行文字戳記？ 在 `TextStamper` 中使用 `
` 標籤來處理多行文字。 例如，"行 1
行 2 "會在第一行產生 "行 1"，在第二行產生 "行 2"。這可建立地址戳記或多行水印。

---

如何在 PDF 上標示圖片？ 建立 `ImageStamper` 物件，並使用 `ApplyStamp` 方法將影像套用至文件。 該方法的第二個參數接受一個頁面索引，用於戳記單個或多個頁面。 以下範例為 PDF 第 1 頁上的圖片蓋章。 所有頁面索引均採用從零開始的索引方式。 對於複雜的影像操作，請探索 [ 將影像加入 PDF](https://ironpdf.com/how-to/add-images-to-pdfs/) 或處理 [base64 編碼的影像](https://ironpdf.com/how-to/base-urls/)。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-image.cs ```

圖章輸出是什麼樣子？

支援哪些影像格式？ `ImageStamper` 透過 URI 引用或檔案路徑支援 PNG、JPEG、GIF 和 SVG。 確保遠端影像的正常網路連線。 對於 Azure 環境，請考慮使用 [來自 Azure Blob Storage 的影像](https://ironpdf.com/how-to/images-azure-blob-storage/)。

---

如何套用多個印章？ 使用 `ApplyMultipleStamps` 透過傳送戳記的陣列來套用多個戳記。 此方法可在單一作業中有效率地處理數個圖章。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-multiple-stamps.cs ```

當郵戳重疊時會發生什麼？

我可以混合使用不同類型的印章嗎？ `ApplyMultipleStamps` 接受包含任何圖章類型的陣列。將 `TextStamper`, `ImageStamper`, `HTMLStamper`, 和 `BarcodeStamper` 結合在一個操作中。 同時建立具有頁眉、頁腳、水印和識別碼的複雜文件版面。

---

如何控制圖章位置？ 使用 3x3 網格定義圖章位置，其中有三個水平列和三個垂直行。 選擇水平對齊方式：左、中、右。 選擇垂直對齊方式：上、中、下。 調整水平與垂直偏移，以達到精確定位。 請參閱下面的圖片，以獲得視覺上的呈現。

關鍵定位屬性是什麼？ - `HorizontalAlignment`：相對於頁面的水平對齊方式。 預設值：`HorizontalAlignment.Center`。 - `VerticalAlignment`：相對於頁面的垂直對齊方式。 預設值：`VerticalAlignment.Middle`。 - `HorizontalOffset`：水平偏移。 預設：0，單位：`MeasurementUnit.Percentage`。 正值向右偏移，負值向左偏移。 - `VerticalOffset`：垂直偏移。 預設：0，單位：`MeasurementUnit.Percentage`。 正值向下偏移，負值向上偏移。

如何設定精確的偏移量？ 使用 `Length` 類指定 `HorizontalOffset` 和 `VerticalOffset` 。 預設測量單位為百分比。 可用的單位包括英吋、毫米、公分、像素和點。 這可實現精確定位，例如在 PDF 文件中 [ 設定自訂邊距](https://ironpdf.com/how-to/custom-margins/)。 ### 程式碼 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-location.cs ```

---

如何為 HTML 內容加上圖章？ 使用 `HtmlStamper` 類來標示文字和圖像。 `HtmlStamper`使用 CSS 設定來渲染 HTML 設計，然後將它們印在 PDF 文件上。 `HtmlBaseUrl` 屬性指定 HTML 字串資產 (如 CSS 和影像檔案) 的基本 URL。 這與 [ 將 HTML 轉換為 PDF](https://ironpdf.com/how-to/html-string-to-pdf/) 使用相同的渲染引擎。 ### 程式碼 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-multiple-stamps.cs ```

哪些是基本的 HTML Stamper 屬性？ - `Html`：將 HTML 片段印在 PDF 上。 對 JavaScript、CSS 和圖片的外部引用是相對於 `HtmlBaseUrl` 而言。 - `HtmlBaseUrl`：外部 CSS、JavaScript 和圖片檔案引用的基本 URL。 - `CssMediaType`: 啟用 Media="screen" CSS 樣式。 設定 `AllowScreenCss=false` 會使用 CSS media="print" 來渲染圖章。 預設：`PdfCssMediaType.Screen`。

為何使用 HTML Stamper 而非 Text Stamper？ `HTMLStamper`在一個圖章中提供完整的 HTML 和 CSS 支援，以支援複雜的佈局、多種字型、顏色和內嵌圖片。是豐富內容水印或標頭的理想選擇。 保持一致的品牌形象，並配合[回應式 CSS 設計](https://ironpdf.com/how-to/html-to-pdf-responsive-css/)。

---

我該如何標示 BarCode？ `BarcodeStamper` 類會直接在現有的 PDF 文件上標示條碼。 支援 QRCode、Code128 及 Code39 條碼類型。 ### 程式碼 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-text.cs ```

Barcode 有哪些配置選項？ - `Value`: 條碼的字串值。 - `BarcodeType`：支援 QRCode、Code128 和 Code39 的編碼類型。預設值：QRCode。 - `寬度`：渲染的 BarCode 寬度，單位為像素。 預設：250px。 - `高度`：渲染後的 BarCode 高度，單位為像素。 預設：250px。

我應該在何時使用每種 BarCode 類型？ QRCode 可處理 URL 和大型資料集（最多可達 4,296 個字母數字字符）。 `Code128` 適合具有高密度要求的字母數字資料。 `Code39` 適用於簡單的數字或大寫字母組合。 選擇 BarCode 類型時，請考慮掃描設備的相容性。

---

有哪些額外的 Stamper 選項？ 這些屬性提供了對圖章外觀和行為的精細控制，類似於 [建立自訂水印](https://ironpdf.com/how-to/custom-watermark/)。

如何控制圖章外觀？ - `透明度`：控制透明度。 0 代表隱形，100 代表不透明。 - `旋轉`：順時針旋轉圖章，從 0 到 360 度。 - `MaxWidth`：輸出戳記的最大寬度。 - `MaxHeight`：輸出圖章的最大高度。 - `MinWidth`：輸出戳記的最小寬度。 - `MinHeight`：輸出圖章的最小高度。 - `超連結`：將按一下的超連結加到蓋章元素。 注意：HTML 連結 (a 標籤) 不會因戳記而保留。 - `刻度`：對圖章套用百分比刻度。 預設值：100 (無效)。 - `IsStampBehindContent`：在內容後方放置圖章。 如果內容不透明，可能看不到圖章。 - `WaitFor`：等待事件或時間。請參閱 [ 使用 WaitFor 延遲 PDF 渲染](https://ironpdf.com/how-to/waitfor/)。 - `Timeout` ：渲染超時時間（秒）。 預設值：60。

哪些屬性最常使用？ `Opacity` 和 `IsStampBehindContent` 會建立水印。 `Scale` 和 `Rotation` 可調整視覺定位和大小。 範例： ```csharp // Create a semi-transparent watermark behind content TextStamper watermark = new TextStamper() { Text = "CONFIDENTIAL", FontSize = 60, FontColorCode = "#CCCCCC", Opacity = 25, Rotation = -45, IsStampBehindContent = true, VerticalAlignment = VerticalAlignment.Middle, HorizontalAlignment = HorizontalAlignment.Center }; ``` ## 摘要 IronPdf 的戳記功能可在現有 PDF 文件中加入文字、圖片、HTML 內容和 BarCode。 四種具有廣泛客製化選項的專業 stamper 類別可建立具有水印、頁首、頁尾和註解的專業文件。 具有各種測量單位和對齊方式選項的定位系統可確保像素完美的位置。 使用簡單的文字戳記或複雜的 HTML 佈局與 CSS 定型。 IronPDF 的戳記 API 為企業級 PDF 操作提供了靈活性和控制性。