如何使用POI设置Word当前页面为横向且不产生多余空白页？

问题根源 #

你当前的代码通过段落添加节属性时，默认使用下一页分节符，会强制在节的位置生成新页面，导致表格页面后出现空白页；删除空白页会连带删除分节符，自然丢失横向设置。

正确实现方案 #

要实现“仅表格所在页面横向且无多余空白页”，需通过连续分节符包裹表格，避免强制分页：

1. 在表格之前插入连续分节符，开启新节并设置横向
2. 在表格之后插入连续分节符，开启新节并恢复纵向页面方向

完整代码示例 #

// 1. 在表格前创建段落，设置连续分节符并开启横向页面
XWPFParagraph beforePara = doc.createParagraph();
CTSectPr beforeSectPr = beforePara.getCTP().addNewPPr().addNewSectPr();
// 设置页面横向及A4尺寸（单位：缇，1缇=1/20磅）
CTPageSz beforePageSz = beforeSectPr.addNewPgSz();
beforePageSz.setOrient(STPageOrientation.LANDSCAPE);
beforePageSz.setW(BigInteger.valueOf(16838));
beforePageSz.setH(BigInteger.valueOf(11906));
// 设置连续分节符，避免生成新页面
CTSectType beforeSectType = beforeSectPr.addNewType();
beforeSectType.setVal(STSectionMark.CONTINUOUS);

// 2. 绘制表格（替换为你自己的表格生成逻辑）
XWPFTable table = doc.createTable(3, 3);
for (int i = 0; i < 3; i++) {
    for (int j = 0; j < 3; j++) {
        table.getRow(i).getCell(j).setText("单元格 " + (i+1) + "-" + (j+1));
    }
}

// 3. 在表格后创建段落，设置连续分节符并恢复纵向页面
XWPFParagraph afterPara = doc.createParagraph();
CTSectPr afterSectPr = afterPara.getCTP().addNewPPr().addNewSectPr();
// 恢复纵向及A4尺寸
CTPageSz afterPageSz = afterSectPr.addNewPgSz();
afterPageSz.setOrient(STPageOrientation.PORTRAIT);
afterPageSz.setW(BigInteger.valueOf(11906));
afterPageSz.setH(BigInteger.valueOf(16838));
// 设置连续分节符
CTSectType afterSectType = afterSectPr.addNewType();
afterSectType.setVal(STSectionMark.CONTINUOUS);

关键说明 #

• STSectionMark.CONTINUOUS分节符：不会强制生成新页面，仅在当前位置开启新节，避免多余空白页
• 明确设置页面宽高：仅修改方向可能导致尺寸异常，手动指定A4纸对应尺寸可保证显示正常
• 前后分节包裹：确保只有表格所在节为横向，其余内容保持纵向

如果需求是整个文档设为横向，无需分节，直接修改文档默认节属性即可：

// 获取或创建文档默认节属性
CTSectPr docSectPr = doc.getDocument().getBody().getSectPr();
if (docSectPr == null) {
    docSectPr = doc.getDocument().getBody().addNewSectPr();
}
// 设置全文档横向及A4尺寸
CTPageSz docPageSz = docSectPr.getPgSz() == null ? docSectPr.addNewPgSz() : docSectPr.getPgSz();
docPageSz.setOrient(STPageOrientation.LANDSCAPE);
docPageSz.setW(BigInteger.valueOf(16838));
docPageSz.setH(BigInteger.valueOf(11906));

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