如何使用 Apache POI 在 Word 中重新啟動編號？

Question

下面的方法添加編號成功。 但是，當我嘗試將編號添加到應該從零開始的其他部分時，第一個列表中添加的編號會在我的第二個列表中繼續。 我如何重新啟動它？

public void numbering(XWPFDocument document) {
    List<XWPFParagraph> list = document.getParagraphs();
    
    CTAbstractNum cTAbstractNum = CTAbstractNum.Factory.newInstance();
    CTLvl cTLvl = cTAbstractNum.addNewLvl();
    cTLvl.addNewNumFmt().setVal(STNumberFormat.DECIMAL);
    cTLvl.addNewLvlText().setVal("1.");
    cTLvl.addNewStart().setVal(BigInteger.valueOf(1));
    
    XWPFAbstractNum abstractNum = new XWPFAbstractNum(cTAbstractNum);
    XWPFNumbering numbering = document.createNumbering();
    BigInteger abstractNumID = numbering.addAbstractNum(abstractNum);
    BigInteger numID = numbering.addNum(abstractNumID);

    for (XWPFParagraph paragraph : list) {
        
        if (paragraph.getText().trim().contains("This is section number one")|| 
                paragraph.getText().trim().contains("This is section number two") ){
            
            System.out.println(paragraph.getText() + " " + list.indexOf(paragraph));
            paragraph.setNumID(numID);
        }
    }
}

Answer 1

在Apache POI 編號列表中，我描述了 Word 中基本編號的工作原理。

為段落設置的NumID確定用於該段落的編號。 因此，如果需要以 1. 開頭的新編號，則需要將新的XWPFAbstractNum添加到XWPFNumbering並需要創建新的NumID 。

最簡單的方法是使用BigInteger getNewDecimalNumberingId(XWPFDocument document, BigInteger abstractNumID)方法實現，如下所示：

 BigInteger getNewDecimalNumberingId(XWPFDocument document, BigInteger abstractNumID) {
  CTAbstractNum cTAbstractNum = CTAbstractNum.Factory.newInstance();
  cTAbstractNum.setAbstractNumId(abstractNumID);

  CTLvl cTLvl = cTAbstractNum.addNewLvl();
  cTLvl.setIlvl(BigInteger.valueOf(0)); // set indent level 0
  cTLvl.addNewNumFmt().setVal(STNumberFormat.DECIMAL);
  cTLvl.addNewLvlText().setVal("%1.");
  cTLvl.addNewStart().setVal(BigInteger.valueOf(1));

  XWPFAbstractNum abstractNum = new XWPFAbstractNum(cTAbstractNum);

  XWPFNumbering numbering = document.createNumbering();

  abstractNumID = numbering.addAbstractNum(abstractNum);

  BigInteger numID = numbering.addNum(abstractNumID);

  return numID;
 }

這通過向NumID添加一個新的XWPFAbstractNum來獲得一個新的XWPFNumbering 。

如何使用的完整示例：

import java.io.FileOutputStream;

import org.apache.poi.xwpf.usermodel.*;

import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTAbstractNum;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTLvl;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STNumberFormat;

import java.math.BigInteger;

public class CreateWordNumberings {

 static BigInteger getNewDecimalNumberingId(XWPFDocument document, BigInteger abstractNumID) {
  CTAbstractNum cTAbstractNum = CTAbstractNum.Factory.newInstance();
  cTAbstractNum.setAbstractNumId(abstractNumID);

  CTLvl cTLvl = cTAbstractNum.addNewLvl();
  cTLvl.setIlvl(BigInteger.valueOf(0)); // set indent level 0
  cTLvl.addNewNumFmt().setVal(STNumberFormat.DECIMAL);
  cTLvl.addNewLvlText().setVal("%1.");
  cTLvl.addNewStart().setVal(BigInteger.valueOf(1));

  XWPFAbstractNum abstractNum = new XWPFAbstractNum(cTAbstractNum);

  XWPFNumbering numbering = document.createNumbering();

  abstractNumID = numbering.addAbstractNum(abstractNum);

  BigInteger numID = numbering.addNum(abstractNumID);

  return numID;
 }

 public static void main(String[] args) throws Exception {

  XWPFDocument document = new XWPFDocument();

  XWPFParagraph paragraph = document.createParagraph();
  XWPFRun run = paragraph.createRun();  
  run.setText("The paragraph before first numbering:");

  //get first NumID for first numbering
  BigInteger numID = getNewDecimalNumberingId(document, BigInteger.valueOf(0));

  paragraph = document.createParagraph();
  paragraph.setNumID(numID);
  run = paragraph.createRun();  
  run.setText("This is first section number one");

  paragraph = document.createParagraph();
  run = paragraph.createRun();  
  run.setText("Lorem ipsum semit dolor ...");

  paragraph = document.createParagraph();
  paragraph.setNumID(numID);
  run = paragraph.createRun();  
  run.setText("This is first section number two");

  paragraph = document.createParagraph();
  run = paragraph.createRun();  
  run.setText("Lorem ipsum semit dolor ...");

  paragraph = document.createParagraph();
  run = paragraph.createRun();  
  run.setText("The paragraph before second numbering:");

  //get second NumID for second numbering
  numID = getNewDecimalNumberingId(document, BigInteger.valueOf(1));

  paragraph = document.createParagraph();
  paragraph.setNumID(numID);
  run = paragraph.createRun();  
  run.setText("This is second section number one");

  paragraph = document.createParagraph();
  run = paragraph.createRun();  
  run.setText("Lorem ipsum semit dolor ...");

  paragraph = document.createParagraph();
  paragraph.setNumID(numID);
  run = paragraph.createRun();  
  run.setText("This is second section number two");

  paragraph = document.createParagraph();
  run = paragraph.createRun();  
  run.setText("Lorem ipsum semit dolor ...");

  paragraph = document.createParagraph();
  paragraph.setNumID(numID);
  run = paragraph.createRun();  
  run.setText("This is second section number three");

  paragraph = document.createParagraph();
  run = paragraph.createRun();  
  run.setText("Lorem ipsum semit dolor ...");

  paragraph = document.createParagraph();

  FileOutputStream out = new FileOutputStream("CreateWordNumberings.docx");
  document.write(out);
  out.close();
  document.close();

 }
}