1. IronQR
  2. 操作指南
  3. 將 QR 碼蓋印至 PDF

如何將 QR 碼嵌入 PDF 頁面

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

將 QR 碼直接嵌入 PDF 文件中，即可立即為頁面添加浮水印，或加入 URL、追蹤 ID 或數位簽章等動態資訊。

在現有 PDF 中加入 QR 碼是文件工作流程中常見的需求。 發票 PDF 檔中可包含一個連結至付款入口網站的 QR 碼。 政府紀錄中可嵌入驗證碼。 活動門票可包含可掃描的識別碼，無需重新調整整個文件的版面配置。 IronQR 讓這一切變得簡單：使用 QrWriter.Write 生成 QR 碼，並透過單一呼叫 DrawBitmap 將其嵌入任何頁面的任意位置。

本指南將示範如何使用 IronQR程式庫，將 QR 碼嵌入現有的 PDF 檔案中。 尚未生成 QR 碼的開發人員，應先參閱《將 QR 碼建立為圖片》指南。

快速入門：在 PDF 中嵌入 QR 碼

生成一個 QR 碼，並將其蓋印至現有 PDF 頁面的特定位置。

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

    PM > Install-Package IronQR

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

    var qrBitmap = QrWriter.Write("https://example.com").Save();
var pdf = PdfDocument.FromFile("document.pdf");
pdf.Pages[0].DrawBitmap(qrBitmap, 505, 20, 70, 70);
pdf.SaveAs("stamped.pdf");

  3. 部署至您的生產環境進行測試

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

    arrow pointer

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

  1. 下載 IronQR C# 程式庫，將 QR 碼嵌入 PDF 檔案
  2. 使用 QrWriter.Write().Save() 產生 QR 碼位圖
  3. 使用 PdfDocument.FromFile() 載入 PDF
  4. 呼叫 DrawBitmap() 時，需傳入頁面索引、x/y 座標及大小
  5. 使用 SaveAs() 儲存修改後的 PDF

在 PDF 頁面中嵌入 QR 碼

若要將 QR 碼嵌入現有 PDF 檔案中，請使用 QrWriter.Write 生成 QR 碼，並透過 Save() 將其儲存至 AnyBitmap 檔案中。 使用 PdfDocument.FromFile 載入目標 PDF，然後使用 DrawBitmap 將 QR 碼放置於精確座標位置。 x 和 y 值以 PDF 點為單位（A4 頁面為 595 × 842 點），而 desiredWidth 和 desiredHeight 則控制水印的大小。

輸入

下方的 QR 碼編碼內容為 https://ironsoftware.com，並將被嵌入 PDF 文件中。

QR 碼位圖編碼 https://ironsoftware.com 
:path=/static-assets/qr/content-code-examples/how-to/stamp-qr-code-to-pdf.cs
using IronQr;
using IronPdf;
using IronSoftware.Drawing;

// Generate QR code bitmap
AnyBitmap qrBitmap = QrWriter.Write("hello world").Save();

// Load the existing PDF
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Stamp the QR code at the top-right corner of page 1
// A4 page is 595 x 842 PDF points; x:505, y:20 places a 70pt QR near the top-right
pdf.DrawBitmap(qrBitmap, 0, 505, 20, 70, 70);

pdf.SaveAs("sample.pdf");

Imports IronQr
Imports IronPdf
Imports IronSoftware.Drawing

' Generate QR code bitmap
Dim qrBitmap As AnyBitmap = QrWriter.Write("hello world").Save()

' Load the existing PDF
Dim pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")

' Stamp the QR code at the top-right corner of page 1
' A4 page is 595 x 842 PDF points; x:505, y:20 places a 70pt QR near the top-right
pdf.DrawBitmap(qrBitmap, 0, 505, 20, 70, 70)

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

修改後的 PDF 已儲存為 SaveAs。 為避免覆寫原始檔案，請傳入不同的輸出路徑。

輸出

QR 碼位於第 1 頁右上角，座標為 (505, 20)，尺寸為 70 × 70 PDF 點。

控制位置與頁碼

x 和 y 參數以 PDF 點為單位，從頁面的左上角開始測量。 增加 x 會將標記向右移動； 增加 y 會將其向下移動。 pageIndex 參數採用零起始計數，因此 pageIndex: 0 對應的第一頁。

以下範例將兩個 QR 碼分別印在不同頁面上——第 1 頁右上角為驗證連結，第 2 頁左下角為支援連結：

輸入

下方的兩個 QR 碼分別編碼了驗證與支援網址，這些連結將被印製在不同的頁面中。

QR code encoding https://ironsoftware.com/verify

第 1 頁輸入內容 — ironsoftware.com/verify 的 QR 碼

QR code encoding https://ironsoftware.com/support

第 2 頁輸入 — ironsoftware.com/support 的 QR 碼 

:path=/static-assets/qr/content-code-examples/how-to/stamp-qr-code-to-pdf-positions.cs
using IronQr;
using IronPdf;
using IronSoftware.Drawing;

PdfDocument pdf = PdfDocument.FromFile("document.pdf");

// Page 1: stamp a verification QR at the top-right corner
AnyBitmap qrVerify = QrWriter.Write("https://ironsoftware.com/verify").Save();
pdf.DrawBitmap(qrVerify, 0, 505, 20, 70, 70);

// Page 2: stamp a support QR at the bottom-left corner
AnyBitmap qrSupport = QrWriter.Write("https://ironsoftware.com/support").Save();
pdf.DrawBitmap(qrSupport, 1, 20, 752, 70, 70);

pdf.SaveAs("document.pdf");

Imports IronQr
Imports IronPdf
Imports IronSoftware.Drawing

Dim pdf As PdfDocument = PdfDocument.FromFile("document.pdf")

' Page 1: stamp a verification QR at the top-right corner
Dim qrVerify As AnyBitmap = QrWriter.Write("https://ironsoftware.com/verify").Save()
pdf.DrawBitmap(qrVerify, 0, 505, 20, 70, 70)

' Page 2: stamp a support QR at the bottom-left corner
Dim qrSupport As AnyBitmap = QrWriter.Write("https://ironsoftware.com/support").Save()
pdf.DrawBitmap(qrSupport, 1, 20, 752, 70, 70)

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

請注意PDF 點是 PDF 頁面座標的測量單位。 A4 頁面的寬度為 595 點，高度為 842 點，左上角座標為 (0, 0)。 若要放置一個 70 pt 的 QR 碼，並在右上角邊緣留出 20 pt 的邊距，請從頁面寬度中減去 QR 碼大小與邊距：x = 595 − 70 − 20 = 505，並保持 y = 20 使其位於頂部附近。 若要將 QR 碼置於左下角，x = 20，並從頁面高度中減去：y = 842 − 70 − 20 = 752.)]

輸出

每個 QR 碼皆置於對應的角落位置——驗證碼位於第 1 頁右上角，支援資訊位於第 2 頁左下角。

使用情境

  • 發票付款連結：將付款入口網站的 URL 進行編碼，並將其印在第 1 頁的右上角，以便客戶掃描後立即付款。
  • 文件驗證：將記錄 ID 或雜湊值進行編碼，並將其標記在每頁底部，以便收件者驗證真實性。
  • 活動門票：請在第 1 頁中央編碼並蓋印參加者 ID 或預訂編號，以便於入場時輕鬆掃描。
  • 產品標籤：將產品網址或序號編碼後，印製於左上角或右下角，以便快速查詢庫存。
  • 法律文件：編碼案件編號或提交參考編號，並將其加蓋於每頁頁尾以利追蹤。

若需在印製前對 QR 碼進行更多控制（例如設定錯誤校正等級或調整輸出尺寸），請先設定 QrOptions 物件，並在呼叫 StampToExistingPdfPage 之前將其傳遞給 QrWriter.Write。

如需更多 QR 碼生成範例，請參閱 C# QR 碼生成器教學指南，並探索 IronQR 的完整功能集。

常見問題

什麼是 IronQR？

IronQR 是一款用於在 .NET 應用程式中生成和處理 QR 碼的強大程式庫，讓您能夠建立、自訂並將 QR 碼整合至各種文件格式中，包括 PDF 檔案。

如何使用 IronQR 在現有 PDF 中嵌入 QR 碼？

您可以透過 IronQR 的 QrWriter.Write 方法生成 QR 碼，再使用 StampToExistingPdfPage 函式將其置入 PDF 頁面的特定座標位置，藉此在現有 PDF 中嵌入 QR 碼。

什麼是 StampToExistingPdfPage 函式？

IronQR 中的 StampToExistingPdfPage 函式可讓您將 QR 碼精確放置於現有 PDF 頁面的特定位置，讓您能為文件添加浮水印或無縫加入動態資料。

IronQR 可用於在文件上添加浮水印嗎？

是的，IronQR 可用於透過在 PDF 頁面加蓋 QR 碼來為文件添加浮水印。此功能可應用於在文件中加入動態資訊或品牌標識。

在 PDF 中整合 QR 碼時，使用 IronQR 有什麼優勢？

IronQR 提供簡易易用的方法來生成 QR 碼並將其嵌入 PDF 文件中，讓您能精確控制 QR 碼的位置與自訂設定，使其成為為文件添加動態內容的理想選擇。

在將 QR 碼嵌入 PDF 之前，是否可以自訂 QR 碼？

是的，透過 IronQR，您可以在將 QR 碼嵌入 PDF 頁面之前，自訂 QR 碼的各項屬性，例如尺寸、顏色及錯誤修正等級。

IronQR 是否支援 PDF 的動態 QR 碼生成功能？

IronQR 支援動態 QR 碼生成，讓您能建立可將最新資訊烙印至 PDF 文件的 QR 碼，因此非常適合需要即時資料更新的情境。

使用 IronQR 將 QR 碼嵌入 PDF 檔案需要哪種程式語言？

IronQR 專為 C# 設計，提供一套強大的程式庫，讓開發人員能將 QR 碼功能整合至 .NET 應用程式中，包括將 QR 碼嵌入 PDF 檔案。

如何使用 IronQR 在 PDF 中指定 QR 碼的放置座標？

在 IronQR 中，您可以透過 StampToExistingPdfPage 函式指定 QR 碼在 PDF 頁面上的精確座標，確保 QR 碼的精準定位。

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

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

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

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

還在往下捲動嗎？

想要快速確認成果嗎？ PM > Install-Package IronQR
執行範例 觀看您的 URL 轉為 QR 碼。