如何使用Apache POI在Word文档中实现悬挂缩进？

我想用Java的Apache POI库格式化Word文档，需要实现如图效果：Item1后加制表位，后面的Name1设置悬挂缩进。尝试过设置段落缩进但没生效，也试过把Item和Name分成独立文本段，都没法达到图中的完美格式。

我试过以下代码，但效果不对：

XWPFParagraph p1 = tableRowThree.getCell(2).addParagraph();
    p1.setIndentationHanging(-1100);
    p1.setAlignment(ParagraphAlignment.LEFT);
    XWPFRun run100=p1.createRun();
    run100.setText("Item1");
    run100.setBold(true);
    run100.setFontSize(11);
    CTR ctr0 = run100.getCTR();
    ctr0.addNewTab();
    XWPFRun run101=p1.createRun();
    run101.setText("Name1");

解决方案 #

要实现这种带制表位的悬挂缩进，关键是给段落设置自定义制表位，同时配合正确的悬挂缩进参数，而非直接设置负的悬挂缩进值。具体实现如下：

修改后的代码 #

XWPFParagraph p1 = tableRowThree.getCell(2).addParagraph();
// 设置首行缩进和悬挂缩进，单位为twip（1英寸=1440twip）
int tabPosition = 1440; // 可根据Item文本宽度调整该值
p1.setIndentationFirstLine(tabPosition);
p1.setIndentationHanging(-tabPosition);
p1.setAlignment(ParagraphAlignment.LEFT);

// 添加左对齐制表位
CTPPr pPr = p1.getCTP().getPPr();
if (pPr == null) pPr = p1.getCTP().addNewPPr();
CTTabs tabs = pPr.addNewTabs();
CTTabStop tabStop = tabs.addNewTab();
tabStop.setVal(STTabJc.LEFT);
tabStop.setPos(BigInteger.valueOf(tabPosition));

// 插入Item文本
XWPFRun run100 = p1.createRun();
run100.setText("Item1");
run100.setBold(true);
run100.setFontSize(11);
// 插入制表符（用POI封装方法更简洁）
run100.addTab();

// 插入Name文本
XWPFRun run101 = p1.createRun();
run101.setText("Name1");

关键说明 #

• 制表位位置tabPosition需根据Item文本的实际宽度调整，确保Name能精准对齐到目标位置。
• 首行缩进和悬挂缩进的绝对值需保持一致，这样才能实现「首行(Item部分)无缩进，后续行(Name换行后)自动缩进」的悬挂效果。
• 直接使用run.addTab()比手动操作CTR更简洁，是POI推荐的制表符插入方式。

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