2022/08 更新

我根據文章內容製作了 Nuget 套件。

PM> Install-Package PdfTemplate.iTextSharp.LGPLv2

這個套件內部使用 iTextSharp.LGPLv2 生成 pdf 文件，因此它的授權較 iTextSharp 和 iText 7 更寬鬆。

• iTextSharp.LGPLv2 -> (LGPL v2.0)
• iTextSharp-> (AGPL)
• iText 7 -> (AGPL)

用法可以參考 Github 內容。
https://github.com/fysh711426/PdfTemplate.iTextSharp.LGPLv2

前言

做報表常會用到 PDF 套版，套版的類型很多，文字、顏色、圖片、Radio、CheckBox、等等...，有時候還要分頁，所以想把這些需求整理起來。

範本製作

範本一般會用 Word 畫出表格後 匯出成 PDF，再用 Adobe Acrobat 將需要填入資料的地方加入表格元件。

下圖為 Word 製作的基本資料表格。

將其匯出成 PDF，再用 Adobe Acrobat 開啟，點選右上角的 工具 開啟選單，然後選擇 表格 內的 編輯。

第一次編輯會詢問 是否自動偵測表格，這裡選 是 可以讓 Acrobat 自動偵測並建立表格，剩下的再手動調整。

點擊欄位兩下開啟 內容視窗，將 名稱 改成給程式對應的欄位名稱。

RadioButton

性別欄位只有男或女且單選，所以用 RadioButton，點選右上角新增欄位，選擇選項按鈕。

RadioButton 為同群組單選的元件，其 名稱 為群組，選項按鈕選擇 為被選取的值，這裡新增男女兩個 RadioButton，將名稱改為 SexGroup，選項按鈕選擇分別改為 Male 和 Female。

CheckBox

興趣欄位可多選，所以用 CheckBox，點選右上角 新增欄位，選擇 核取框。

CheckBox 不像 RadioButton 有 群組 概念，每個 CheckBox 都有自己的名稱，判斷是否被勾選，要看內容視窗裡的 轉存值，預設為 是，只要程式丟過來的值等於 轉存值，CheckBox 就會被勾選。

Image

圖片套版會使用 按鈕 元件，將背景色設為 白色，利用按鈕的 icon 來替換圖片。

開啟內容視窗改變背景色。

Barcode

Barcode 部分不用更改，使用 文字欄位 即可。

結果

完整程式太長就不貼上來，下方分享常用功能。

第一頁

第二頁

常用功能程式碼

會用到 iTextSharp 可用 Nuget 安裝。

• iTextSharp 主結構

//可以是任何 Stream 類型 (MemoryStream、FileStream、OutputStream)
var stream = new MemoryStream();

//建立文件
using (var doc = new Document())
{
    using (var writer = PdfWriter.GetInstance(doc, stream))
    {
        doc.Open();

        //操作 PDF ...

        doc.Close();
    }
}

• 文字

using (var ms = new MemoryStream())
{
    using (var reader = new PdfReader("範本檔路徑"))
    {
        using (var stamper = new PdfStamper(reader, ms))
        {
            //取得表單
            var form = stamper.AcroFields;
            //套入文字
            form.SetField("Name", "王小明");
        }
    }
}

• 文字顏色

using (var ms = new MemoryStream())
{
    using (var reader = new PdfReader("範本檔路徑"))
    {
        using (var stamper = new PdfStamper(reader, ms))
        {
            //取得表單
            var form = stamper.AcroFields;
            //套入文字
            form.SetField("Name", "王小明");
            //套入顏色
            var color = "#FF0000";   //紅色
            var baseColor = new BaseColor(System.Drawing.ColorTranslator.FromHtml(color));
            form.SetFieldProperty("Name", "textcolor", baseColor, null);
        }
    }
}

• RadioButton 和 CheckBox

using (var ms = new MemoryStream())
{
    using (var reader = new PdfReader("範本檔路徑"))
    {
        using (var stamper = new PdfStamper(reader, ms))
        {
            //取得表單
            var form = stamper.AcroFields;
            //RadioButton
            form.SetField("Group", "男", true);
            //CheckBox
            form.SetField("Name", "是", true);
        }
    }
}

• 圖片

using (var ms = new MemoryStream())
{
    using (var reader = new PdfReader("範本檔路徑"))
    {
        using (var stamper = new PdfStamper(reader, ms))
        {
            //取得表單
            var form = stamper.AcroFields;
            //取得圖片
            var image = iTextSharp.text.Image.GetInstance("圖片檔路徑");
            //取得按鈕元件
            var pushbuttonField = form.GetNewPushbuttonFromField("Name");
            //指定為 ICON
            pushbuttonField.Layout = PushbuttonField.LAYOUT_ICON_ONLY;
            //圖片等比縮放
            pushbuttonField.ProportionalIcon = true;
            pushbuttonField.Image = image;
            //取代原按鈕
            form.ReplacePushbuttonField("Name", pushbuttonField.Field);
        }
    }
}

• Barcode39

using (var ms = new MemoryStream())
{
    using (var reader = new PdfReader("範本檔路徑"))
    {
        using (var stamper = new PdfStamper(reader, ms))
        {
            //取得表單
            var form = stamper.AcroFields;
            //取得欄位位置資訊
            var fieldPosition = form.GetFieldPositions("Name")[0];
            var pdfContentByte = stamper.GetOverContent(fieldPosition.page);
            var barcode = new Barcode39();
            //barcode 內容
            barcode.Code = "123456789";
            //顯示文字是否前後加上星號
            barcode.StartStopText = false;
            //條碼線最小寬度
            barcode.X = 0.8f;
            //設置墨水擴散量，從每個條碼線中減去該值
            barcode.InkSpreading = 0f;
            //為某些類型保留條碼線的乘數
            barcode.N = 2f;
            //字體大小
            barcode.Size = 10f;
            //文本和條形碼之間的距離
            barcode.Baseline = 10f;
            //barcode 高度
            barcode.BarHeight = 20f;
            barcode.GenerateChecksum = false;
            barcode.ChecksumText = false;
            //產生 barcode 圖片
            var image = barcode.CreateImageWithBarcode(pdfContentByte, BaseColor.BLACK, BaseColor.BLACK);
            var rect = fieldPosition.position;
            //設定圖片座標，以欄位的左下角為原點
            image.SetAbsolutePosition(rect.Left, rect.Bottom);
            pdfContentByte.AddImage(image);
        }
    }
}

• 插入段落

using (var ms = new MemoryStream())
{
    using (var reader = new PdfReader("範本檔路徑"))
    {
        using (var stamper = new PdfStamper(reader, ms))
        {
            //取得表單
            var form = stamper.AcroFields;
            //新增段落
            var paragraph = new Paragraph("abc");
            //取得欄位位置資訊
            var fieldPositions = form.GetFieldPositions("Name");
            //設定行距
            paragraph.Leading = 30;
            //設定第一列縮排
            paragraph.FirstLineIndent = 24;
            //設定對齊方式
            paragraph.Alignment = iTextSharp.text.Element.ALIGN_JUSTIFIED;

            foreach (var position in fieldPositions)
            {
                var pdfContentByte = stamper.GetOverContent(position.page);
                var columnText = new ColumnText(pdfContentByte);

                //ColumnText 呼叫 AddElement 後，自動由 Text 模式轉為 Composite 模式
                columnText.AddElement(paragraph);
                //設定 ColumnText 邊界
                columnText.SetSimpleColumn(position.position.Left, position.position.Bottom, position.position.Right, position.position.Top);
                columnText.Go();
            }
        }
    }
}

• 插入浮水印

using (var ms = new MemoryStream())
{
    using (var reader = new PdfReader("範本檔路徑"))
    {
        using (var stamper = new PdfStamper(reader, ms))
        {
            //取得表單
            var form = stamper.AcroFields;
            //取得欄位位置資訊
            var fieldPositions = form.GetFieldPositions("");
            foreach (var position in fieldPositions)
            {
                var pdfContentByte = stamper.GetUnderContent(position.page);
                pdfContentByte.BeginText();
                var baseFont = BaseFont.CreateFont("字型檔路徑", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
                //設定字型和字體大小
                pdfContentByte.SetFontAndSize(baseFont, 120);
                //設定字體顏色
                pdfContentByte.SetRGBColorFill(210, 210, 210);
                //設定浮水印透明度
                pdfContentByte.SetGState(new PdfGState
                {
                    FillOpacity = 0.6f,    //背景
                    StrokeOpacity = 0.6f   //文字
                });
                //取得當前頁面的位置資訊
                var rect = reader.GetPageSizeWithRotation(position.page);
                var x = (rect.Right + rect.Left) / 2;   //取得頁面 x 軸中心座標
                var y = (rect.Bottom + rect.Top) / 2;   //取得頁面 y 軸中心座標
                //設定浮水印
                pdfContentByte.ShowTextAligned(PdfContentByte.ALIGN_CENTER, "浮水印", x, y, 45);
                pdfContentByte.EndText();
            }
        }
    }
}

• 防止表單編輯

using (var ms = new MemoryStream())
{
    using (var reader = new PdfReader("範本檔路徑"))
    {
        using (var stamper = new PdfStamper(reader, ms))
        {
            //表單扁平化，防止表單編輯
            stamper.FormFlattening = true;
        }
    }
}

• 設定字型

var baseFont1 = BaseFont.CreateFont("字型檔1路徑", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
var baseFont2 = BaseFont.CreateFont("字型檔2路徑", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);

//表單設定字型
stamper.AcroFields.AddSubstitutionFont(baseFont1);
stamper.AcroFields.AddSubstitutionFont(baseFont2);

//段落設定字型
var font1 = new Font(baseFont1, 12f, Font.NORMAL);
var font2 = new Font(baseFont2, 12f, Font.NORMAL);

var selector = new iTextSharp.text.pdf.FontSelector();
selector.AddFont(font1);
selector.AddFont(font2);

var paragraph = new iTextSharp.text.Paragraph();
paragraph.Add(selector.Process("abc一二三"));

• 合併 PDF 產生分頁

//要合併的多個 PDF 文件
var files = new List<byte[]>();

using (var doc = new Document())
{
    using (var writer = PdfWriter.GetInstance(doc, stream))
    {
        doc.Open();

        var contentByte = writer.DirectContent;

        foreach(var file in files)
        {
            using (var reader = new PdfReader(file))
            {
                for (var i = 1; i <= reader.NumberOfPages; i++)
                {
                    //設定頁面大小為當前範本的頁面的大小
                    doc.SetPageSize(reader.GetPageSize(i));
                    //產生新頁面
                    doc.NewPage();
                    //將 Reader 轉為 PdfImportedPage
                    var newPage = writer.GetImportedPage(reader, i);
                    //插入新頁面
                    contentByte.AddTemplate(newPage, 0, 0);
                }
                //釋放 reader
                writer.FreeReader(reader);
            }
        }
        
        doc.Close();
    }
}

參考文章

使用ASP .NET (C#) 產生PDF檔的好幫手—iTextSharp library (上)
c#使用itextsharp输出pdf(动态填充表单内容,显示中文)
How to change the text color of an AcroForm field?
使用iTextSharp進行PDF檔案套版
iTextSharp Fill Pdf Form Image Field
Code 39/128 Barcode Image Generator
[iTextSharp学习笔记]在指定的位置上添加文本
CSharp - 在每個頁面上，使用水印創建 C# itextsharp PDF
如何使用itextsharp将表单字段添加到现有的pdf中？
Missing character in custom font
itextsharp - 如何使用iTextSharp組合多個不包括分頁符的PDF文件？