C#使用Free Spire.PDF for .NET实现为PDF文档添加页码

dotnet add package FreeSpire.PDF

Install-Package FreeSpire.PDF

using Spire.Pdf;
using Spire.Pdf.Graphics;
using Spire.Pdf.AutomaticFields;
using System.Drawing;

using Spire.Pdf;
using Spire.Pdf.AutomaticFields;
using Spire.Pdf.Graphics;
using System.Drawing;

namespace AddPageNumbers
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 加载PDF文档
            PdfDocument pdf = new PdfDocument();
            pdf.LoadFromFile("示例文档.pdf");

            // 2. 创建字体（建议使用系统中存在的通用字体）
            PdfTrueTypeFont font = new PdfTrueTypeFont("宋体", 10f, PdfFontStyle.Regular, true);

            // 3. 创建页码字段和总页数字段
            PdfPageNumberField pageNumber = new PdfPageNumberField();
            PdfPageCountField pageCount = new PdfPageCountField();

            // 4. 组合字段，格式为"第X页，共Y页"（支持中文）
            PdfCompositeField compositeField = new PdfCompositeField(
                font, 
                PdfBrushes.Black, 
                "第 {0} 页 / 共 {1} 页", 
                pageNumber, 
                pageCount);

            // 5. 设置页码位置（基于第一页尺寸，通常各页尺寸一致）
            //    定位到页面底部居中靠左，距左边距72点（1英寸），距底边45点
            float leftMargin = 72f;
            float bottomMargin = 45f;
            SizeF pageSize = pdf.Pages[0].Size;   // 获取基准页面尺寸
            compositeField.Location = new PointF(leftMargin, pageSize.Height - bottomMargin);

            // 6. 遍历每一页，在页面底部绘制页码
            for (int i = 0; i < pdf.Pages.Count; i++)
            {
                PdfPageBase page = pdf.Pages[i];
                // 使用无参 Draw，自动应用 Location
                compositeField.Draw(page.Canvas);
            }

            // 7. 保存文档
            pdf.SaveToFile("添加页码后的文档.pdf");
            pdf.Close();
            pdf.Dispose();
        }
    }
}

// 中文格式
"第 {0} 页 / 共 {1} 页"

// 英文格式
"Page {0} of {1}"

// 简单格式
"{0}/{1}"

// 需要先测量文本宽度，再计算居中坐标
string sampleText = "第 999 页 / 共 999 页";  // 最宽情况
SizeF textSize = font.MeasureString(sampleText);
float x = (pageSize.Width - textSize.Width) / 2;
float y = pageSize.Height - bottomMargin;
compositeField.Location = new PointF(x, y);

float rightMargin = 72f;
string sampleText = "第 999 页 / 共 999 页";
SizeF textSize = font.MeasureString(sampleText);
float x = pageSize.Width - textSize.Width - rightMargin;
float y = pageSize.Height - bottomMargin;
compositeField.Location = new PointF(x, y);

float topMargin = 30f;
string sampleText = "第 999 页 / 共 999 页";
SizeF textSize = font.MeasureString(sampleText);
float x = (pageSize.Width - textSize.Width) / 2;
float y = topMargin;
compositeField.Location = new PointF(x, y);

// 设置字体为 Arial、12号、粗体
PdfTrueTypeFont font = new PdfTrueTypeFont("Arial", 12f, PdfFontStyle.Bold, true);

// 设置颜色为蓝色
PdfBrush brush = PdfBrushes.Blue;

for (int i = 0; i < pdf.Pages.Count; i++)
{
    PdfPageBase page = pdf.Pages[i];
    SizeF pageSize = page.Size;
    // 根据当前页尺寸计算位置
    float x = (pageSize.Width - textWidth) / 2;
    float y = pageSize.Height - bottomMargin;
    compositeField.Location = new PointF(x, y);
    compositeField.Draw(page.Canvas);
}