如何在Java POI XWPF中设置段落的"Keep with next"属性？

嘿，这个需求我之前也踩过坑！Word里的「与下段同页」功能，在POI XWPF的高层API里确实没有直接提供对应的方法，但我们可以直接操作底层的OOXML对象来实现，其实很简单。

核心实现思路 #

Word的段落格式设置在OOXML里是通过CTPPr（段落属性）对象来管理的，「与下段同页」对应的就是keepNext属性。我们只需要给目标段落的CTPPr添加这个属性并设置为启用状态即可。

代码示例 #

假设你已经获取到了需要设置的标题段落对象XWPFParagraph titlePara，可以这样写：

// 获取或创建段落属性对象
CTPPr pPr = titlePara.getCTP().getPPr();
if (pPr == null) {
    pPr = titlePara.getCTP().addNewPPr();
}

// 添加并启用「与下段同页」设置
CTKeepNext keepNext = pPr.addNewKeepNext();
keepNext.setVal(STOnOff.TRUE);

封装成工具方法（可选） #

如果需要多次使用这个功能，建议封装成一个工具函数，方便复用：

import org.apache.poi.xwpf.usermodel.XWPFParagraph;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTKeepNext;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTPPr;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STOnOff;

public class WordParagraphUtils {
    public static void setKeepWithNext(XWPFParagraph para, boolean enable) {
        CTPPr pPr = para.getCTP().getPPr();
        if (pPr == null) {
            pPr = para.getCTP().addNewPPr();
        }
        
        CTKeepNext existingKeepNext = pPr.getKeepNext();
        if (enable) {
            if (existingKeepNext == null) {
                existingKeepNext = pPr.addNewKeepNext();
            }
            existingKeepNext.setVal(STOnOff.TRUE);
        } else {
            if (existingKeepNext != null) {
                pPr.unsetKeepNext();
            }
        }
    }
}

使用的时候直接调用：

WordParagraphUtils.setKeepWithNext(titlePara, true);

验证效果 #

生成Word文档后，右键段落打开「段落」对话框，切换到「换行和分页」选项卡，就能看到「与下段同页」已经被勾选上了，和手动设置的效果完全一致。

内容的提问来源于stack exchange，提问作者Jose Miguel Boeres Filho