java - 为带有页码指示的 XWPFDocument 创建目录

Question

我实际上是用 Apache POI 生成一个 Word 文档，我需要自动创建一个引用段落的目录 (TOC)，以及它们的页面指示。

这是我正在使用的代码(我省略了前提条件和内部方法的主体):

XWPFDocument doc = new XWPFDocument(OPCPackage.openOrCreate(new File(document)));

String strStyleId = "Index Style";
addCustomHeadingStyle(doc, strStyleId, 1);

XWPFParagraph documentControlHeading = doc.createParagraph();
changeText(documentControlHeading, "First try");
documentControlHeading.setAlignment(ParagraphAlignment.LEFT);
documentControlHeading.setPageBreak(true);
documentControlHeading.setStyle(strStyleId);

XWPFParagraph documentControlHeading1 = doc.createParagraph();
changeText(documentControlHeading1, "Second try");
documentControlHeading1.setAlignment(ParagraphAlignment.LEFT);
documentControlHeading1.setPageBreak(true);
documentControlHeading1.setStyle(strStyleId);

doc.createTOC();

当我打开生成的文档时，我得到了这个结果(见蓝色方 block ):

在左侧部分，我可以看到生成的目录。到目前为止，一切都很好。然而，在文档的正文中，我只能看到一个静态文本“目录”，根本没有任何指示(既不是段落也不是页面)。我什至无法与之互动。

如果我单击菜单项“目录”(左上角的红色方 block )，就会生成我想要的“真实”目录(当然是按照箭头... .).

我的问题是:如何从代码中获得第二个结果(红色目录)？

非常感谢。

旁注:我什至尝试将 doc.enforceUpdateFields(); 放在 doc.createTOC(); 之后，但是TOC 就这样消失了。

@Sucy，我添加了您请求的方法。不过，不知道您是否能发现它们有用:

/*
 * Adds a custom style with the given indentation level at the given document.
 */
private static void addCustomHeadingStyle(XWPFDocument docxDocument, String strStyleId, int headingLevel) {

    CTStyle ctStyle = CTStyle.Factory.newInstance();
    ctStyle.setStyleId(strStyleId);

    CTString styleName = CTString.Factory.newInstance();
    styleName.setVal(strStyleId);
    ctStyle.setName(styleName);

    CTDecimalNumber indentNumber = CTDecimalNumber.Factory.newInstance();
    indentNumber.setVal(BigInteger.valueOf(headingLevel));

    // lower number > style is more prominent in the formats bar
    ctStyle.setUiPriority(indentNumber);

    CTOnOff onoffnull = CTOnOff.Factory.newInstance();
    ctStyle.setUnhideWhenUsed(onoffnull);

    // style shows up in the formats bar
    ctStyle.setQFormat(onoffnull);

    // style defines a heading of the given level
    CTPPr ppr = CTPPr.Factory.newInstance();
    ppr.setOutlineLvl(indentNumber);
    ctStyle.setPPr(ppr);

    XWPFStyle style = new XWPFStyle(ctStyle);

    // is a null op if already defined
    XWPFStyles styles = docxDocument.createStyles();

    style.setType(STStyleType.PARAGRAPH);
    styles.addStyle(style);

}

/*
 * Changes the text of a given paragraph.
 */
public static void changeText(XWPFParagraph p, String newText) {
    if (p != null) {
        List<XWPFRun> runs = p.getRuns();
        for (int i = runs.size() - 1; i >= 0; i--) {
            p.removeRun(i);
        }

        if (runs.size() == 0) {
            p.createRun();
        }

        XWPFRun run = runs.get(0);
        run.setText(newText, 0);
    }
}

Answer 1

您所看到的 XWPF 类是一项正在进行的工作，没有真正的总体架构。随着我们的努力，这会随着时间的推移而改变，但与此同时，您可以尝试以这种方式向段落添加一个简单的 TOC 字段。

XWPFParagraph p;
...
// get or create your paragraph
....
CTP ctP = p.getCTP();
CTSimpleField toc = ctP.addNewFldSimple();
toc.setInstr("TOC \\h");
toc.setDirty(STOnOff.TRUE);

这将创建一个带有页面超链接的目录，当 Word 打开它时应该重新计算目录，目录将基于预定义的 HeaderX 样式。