如何使用Apache POI在长表格延续到第二页时移除或隐藏页脚

Word的页脚是和文档节（Section）绑定的，不同节可以独立配置页脚内容、是否显示页脚，Apache POI没有提供直接针对「表格跨页自动隐藏页脚」的封装API，需要通过分节+独立页脚配置的方式实现，核心逻辑为：把跨页的表格内容划分到独立的文档节中，给该节配置空白页脚，表格渲染完成后再切回原有页脚配置即可。

具体实现步骤 #

• 计算分页临界点
  先获取当前文档的页面尺寸、上下边距，算出单页可容纳的内容总高度，再逐行累加表格每行的高度（包含行高、单元格内边距、段落间距、嵌入内容高度），当累加高度超过单页可用高度时，记录该行作为跨页的起始位置。
  参考计算代码：

  // 获取当前文档默认页面配置，单位为twips
  CTSectPr baseSectPr = doc.getDocument().getBody().getSectPr();
  CTPageSz pageSize = baseSectPr.getPgSz();
  CTPageMar pageMargin = baseSectPr.getPgMar();
  // 单页可容纳内容高度 = 页面总高度 - 上边距 - 下边距
  long pageAvailableHeight = pageSize.getH() - pageMargin.getTop() - pageMargin.getBottom();
  

• 在分页位置插入下一页分节符
  在跨页起始行的位置插入类型为NEXT_PAGE的分节符，将跨页部分的表格划入独立的新节，注意不要破坏原有表格的结构。

  // 在跨页首行前插入带分节符的段落
  XWPFParagraph breakPara = new XWPFParagraph(跨页首行.getCtRow().insertNewP(0), doc);
  CTPPr pPr = breakPara.getCTP().isSetPPr() ? breakPara.getCTP().getPPr() : breakPara.getCTP().addNewPPr();
  CTSectPr crossSectPr = pPr.addNewSectPr();
  // 设置分节符类型为下一页
  crossSectPr.addNewType().setVal(STSectionMark.NEXT_PAGE);
  

• 给跨页节配置空页脚
  新建的节默认会继承前一节的页脚配置，需要先取消「链接到前一节」的设置，再将该节的页脚内容清空，实现页脚隐藏效果：

  // 获取刚创建的跨页节
  XWPFSection crossSection = doc.getSections().get(doc.getSections().size() - 1);
  XWPFFooter crossFooter = crossSection.getFooter(HeaderFooterType.DEFAULT);
  // 取消链接前一节页脚
  crossFooter.setLinkedToPrevious(false);
  // 清空页脚所有内容
  crossFooter.clearParagraphs();
  

• 表格结束后恢复原有页脚
  等长表格的所有内容渲染完成后，再插入一个NEXT_PAGE类型的分节符创建新节，将该节的页脚重新配置为原本需要显示的内容，保证表格后续的页面页脚显示正常。

注意事项 #

• 如果长表格跨多页（超过2页），需要逐页计算分页位置，每一页跨页段都划入独立节配置空页脚，直到表格结束再恢复原页脚
• 行高计算时要把单元格内的图片、特殊控件的高度一并计入，避免分页位置计算偏差导致页脚隐藏范围出错
• 必须使用NEXT_PAGE类型分节符，不要用连续分节符，否则节划分不会触发新页，页脚配置无法按页生效
• 如果仅需要避免页脚和跨页表格重叠，不需要完全隐藏页脚，可以直接调整页脚的页边距、设置表格无文字环绕即可，不需要做分节处理。

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