C#使用iText7生成PDF时如何判断新增内容是否跳转至下一页

iText7处理这类需求有两种成熟方案，优先推荐事件监听方案，无需手动判断跨页逻辑，出错概率更低。

方案一：使用页面事件监听器实现动态页眉（推荐） #

iText7提供了事件回调机制，每次新页面创建时会自动触发对应事件，你可以在事件中根据页码设置不同的页眉，完全不需要手动判断段落是否跨页。
实现步骤如下：

1. 自定义页眉事件类，实现IEventHandler接口
2. 把事件注册到PdfDocument实例上
3. 事件触发时根据当前页码渲染对应页眉

代码示例：

// 自定义页眉事件处理器
public class HeaderEventHandler : IEventHandler
{
    public void HandleEvent(Event @event)
    {
        PdfDocumentEvent docEvent = (PdfDocumentEvent)@event;
        PdfDocument pdfDoc = docEvent.GetDocument();
        PdfPage page = docEvent.GetPage();
        int pageNum = pdfDoc.GetPageNumber(page);
        
        Canvas canvas = new Canvas(page, page.GetPageSize());
        // 第一页用原有页眉，后续页面用新页眉
        if (pageNum == 1)
        {
            canvas.Add(new Paragraph("HEADER")
                .SetTextAlignment(TextAlignment.CENTER)
                .SetFontSize(20)
                .SetMarginTop(20));
            canvas.Add(new Paragraph("SUB HEADER")
                .SetTextAlignment(TextAlignment.CENTER)
                .SetFontSize(15)
                .SetMarginTop(5));
            canvas.Add(new LineSeparator(new SolidLine())
                .SetMarginTop(5));
        }
        else
        {
            // 这里设置其他页面的页眉
            canvas.Add(new Paragraph("NEW PAGE HEADER")
                .SetTextAlignment(TextAlignment.CENTER)
                .SetFontSize(18)
                .SetMarginTop(20));
            canvas.Add(new LineSeparator(new SolidLine())
                .SetMarginTop(5));
        }
        canvas.Close();
    }
}

修改你的主程序代码，注册事件即可：

static void Main(string[] args)
{
    PdfWriter writer = new PdfWriter("C:\\test\\demo.pdf");
    PdfDocument pdf = new PdfDocument(writer);
    // 注册页面创建事件
    pdf.AddEventHandler(PdfDocumentEvent.START_PAGE, new HeaderEventHandler());
    // 注意这里要给文档设置上边距，避免正文和页眉重叠
    Document document = new Document(pdf, PageSize.A4, 36, 36, 72, 36);

    // 这里不需要再手动加页眉了，事件会自动处理
    // 直接添加正文段落即可
    for (int i = 0; i < 200; i++)
    {
        Paragraph paragraph1 = new Paragraph("Lorem ipsum " +
        "dolor sit amet, consectetur adipiscing elit, " +
        "sed do eiusmod tempor incididunt ut labore " +
        "et dolore magna aliqua.");
        document.Add(paragraph1);
    }
    document.Close();
}

方案二：手动计算剩余空间判断是否跨页 #

如果你确实需要在添加段落前主动判断是否会跳到下一页，可以通过计算当前页面剩余可用高度和段落的渲染高度来判断：

// 扩展方法：获取指定段落的渲染高度
public static float GetParagraphHeight(Paragraph paragraph, Document document)
{
    var renderer = paragraph.CreateRendererSubTree();
    renderer.SetParent(document.GetRenderer());
    var result = renderer.Layout(new LayoutContext(new LayoutArea(0, 
        new Rectangle(document.GetPageEffectiveArea(PageSize.A4).GetWidth(), 1000f))));
    return result.GetOccupiedArea().GetBBox().GetHeight();
}

在添加段落前判断：

for (int i = 0; i < 200; i++)
{
    Paragraph paragraph1 = new Paragraph("Lorem ipsum " +
    "dolor sit amet, consectetur adipiscing elit, " +
    "sed do eiusmod tempor incididunt ut labore " +
    "et dolore magna aliqua.");

    // 计算当前页面剩余可用高度
    float currentY = document.GetRenderer().GetCurrentArea().GetBBox().GetY();
    float remainingHeight = currentY - document.GetBottomMargin();
    // 计算段落高度
    float paraHeight = GetParagraphHeight(paragraph1, document);

    if (remainingHeight < paraHeight)
    {
        // 剩余高度不够，这段会被渲染到下一页，你可以在这里执行新页眉的逻辑
        // 注意不要手动加新页，iText会自动处理
    }

    document.Add(paragraph1);
}

注意事项：

• 手动计算高度要考虑段落的边距、行距等样式，计算结果才准确
• 方案二只适合特殊场景，优先用事件监听方案，性能和稳定性更高

内容的提问来源于stack exchange，提问作者Jung