Stamp Text & Image on PDFs using C# and IronPDF

輸出的PDF檔案是什麼樣子的？

如何建立多行文字圖章？

在 TextStamper 中使用 <br> 標籤表示多行文字。 例如，"第 1 行
"第 2 行"會在第一行產生"第 1 行"，在第二行產生"第 2 行"。這樣就可以建立地址印章或多行浮水印。

影像印章輸出是什麼樣的？

支援哪些圖像格式？

ImageStamper 支援透過 URI 引用或檔案路徑來傳輸 PNG、JPEG、GIF 和 SVG 檔案。 確保遠端鏡像的網路連線正常。 對於 Azure 環境，請考慮使用Azure Blob 儲存體中的映像。

郵票重疊會發生什麼事？

我可以混用不同類型的印章嗎？

ApplyMultipleStamps 接受包含任何印章類型的陣列。將 HTMLStamper 和 BarcodeStamper 合併為一個操作。 同時建立包含頁首、頁尾、浮水印和識別碼的複雜文件版面。

關鍵定位屬性有哪些？

• HorizontalAlignment: 相對於頁面的水平對齊方式。 預設值：HorizontalAlignment.Center。
• VerticalAlignment: 相對於頁面的垂直對齊方式。 預設值：VerticalAlignment.Middle。
• HorizontalOffset: 水平偏移。 預設值：0，單位：MeasurementUnit.Percentage。 正值向右偏移，負值向左偏移。
• VerticalOffset: 垂直偏移。 預設值：0，單位：MeasurementUnit.Percentage。 正值向下偏移，負值向上偏移。

如何設定精確偏移量？

使用 Length 類別指定 HorizontalOffset 和 VerticalOffset。 預設計量單位為百分比。 可用單位包括英吋、毫米、公分、像素和點。 這樣就可以精確定位，例如在 PDF 文件中設定自訂邊距。

程式碼

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-location.cs

using IronPdf.Editing;
using System;

// Create text stamper
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    HorizontalAlignment = HorizontalAlignment.Center,
    VerticalAlignment = VerticalAlignment.Top,

    // Specify offsets
    HorizontalOffset = new Length(10),
    VerticalOffset = new Length(10),
};

程式碼

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-multiple-stamps.cs

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create two text stampers
TextStamper stamper1 = new TextStamper()
{
    Text = "Text stamp 1",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Left,
};

TextStamper stamper2 = new TextStamper()
{
    Text = "Text stamp 2",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Right,
};

Stamper[] stampersToApply = { stamper1, stamper2 };

// Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply);

pdf.SaveAs("multipleStamps.pdf");

HTML Stamper 的基本屬性有哪些？

• Html: 若要新增至 PDF 中的 HTML 片段。 對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 設計。

程式碼

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-text.cs

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create text stamper
TextStamper textStamper = new TextStamper()
{
    Text = "Text Stamper!",
    FontFamily = "Bungee Spice",
    UseGoogleFont = true,
    FontSize = 30,
    IsBold = true,
    IsItalic = true,
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the text stamper
pdf.ApplyStamp(textStamper);

pdf.SaveAs("stampText.pdf");

條碼有哪些設定選項？

• Value: 條碼的字串值。
• BarcodeType: 支援 QRCode、Code128 和 Code39 的編碼類型。預設值：QRCode。
• Width: 以像素為單位的渲染條碼寬度。 預設值：250px。
• Height: 以像素為單位的渲染條碼高度。 預設值：250px。

我應該在什麼情況下使用哪種條碼？

二維碼可以處理網址和大型資料集(最多 4,296 個字母數字字元)。 Code128 適用於高密度要求的字母數字資料。 Code39 適用於簡單的數字或大寫字母組合。 選擇條碼類型時，請考慮掃描設備的相容性。

如何控製印章外觀？

• Opacity: 控制透明度。 0 表示不透明，100 表示不透明。
• Rotation: 將印章順時針旋轉 0 到 360 度。
• MaxWidth: 輸出戳記的最大寬度。
• MaxHeight: 輸出戳記的最大高度。
• MinWidth: 輸出戳記的最小寬度。
• MinHeight: 輸出戳記的最小高度。
• Hyperlink: 為有戳記的元素新增點擊超連結。 注意：HTML 連結(a 標籤)不會被浮水印保留。
• Scale: 對郵票套用百分比刻度。 預設值：100(無效果)。
• IsStampBehindContent: 將印章放置在內容後方。 如果內容不透明，則印章可能不可見。
• WaitFor: 等待事件或時間。請參閱使用 WaitFor 延遲 PDF 渲染。
• Timeout: 渲染超時時間(秒)。 預設值：60。

最常用的屬性有哪些？

Opacity 和 IsStampBehindContent 建立浮水印。 Scale 和 Rotation 調整視覺定位和大小。 例子：

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

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