Как я могу использовать предопределенные форматы в DOCX с POI?

Question

Я создаю генератор docx с POI и хотел бы использовать предопределенные форматы.

Word включает в себя несколько форматов, таких как Название, Заголовок 1..10 и т. Д. Эти форматы предопределены в каждом DOCX, который вы создаете с помощью Word.

Я бы хотел использовать их в своем генераторе документов. Я попробовал следующее, но формат не был применен:

paragraph = document.createParagraph();
lastParagraph.setStyle("Heading1");

Я также попробовал "заголовок 1", "заголовок1" и "заголовок1" как стиль, но ни один из них не сработал.
Документация API не показывает никаких подробностей.

Я проанализировал файл docx, созданный в Word 2007, и обнаружил, что «Заголовок1» будет правильным. К сожалению, стиль не определен в docx. Нужно ли создавать этот стиль вручную?

Может кто-нибудь указать мне правильное решение?

Answer 1

Все очень просто: используйте docx-файл шаблона.

1. Создание пустого файла docx с Word 2007.
2. Используйте этот файл как шаблон для вашего XWPFDocument
3. Добавьте свои абзацы со стилями.

Вот код:

XWPFDocument document = new XWPFDocument(new FileInputStream("template.docx");
paragraph = document.createParagraph();
paragraph.setStyle("Heading1");

Шаблон содержит все стили, поэтому на них можно ссылаться через setStyle("Heading1");.

Answer 2

Если вы, как правило, заинтересованы в создании стиля, который распознается как заголовок уровня 1 (например, для использования в оглавлении, сгенерированном в MS Word) и может быть доступен на панели форматов Word, это можно сделать следующим образом:

private static File writeSimpleDocxFile(String content) throws IOException {
    XWPFDocument docxDocument = new XWPFDocument();

    String strStyleId = "ownstyle1";

    addCustomHeadingStyle(docxDocument, strStyleId, 1);

    XWPFParagraph paragraph = docxDocument.createParagraph();
    XWPFRun run = paragraph.createRun();
    run.setText(content);

    paragraph.setStyle(strStyleId);
}

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);

}

Да, этот стиль будет отображаться в файле styles.xml.

(я знаю: это не прямой ответ на ваш вопрос, но, поскольку я не нашел эту информацию в Интернете в удобной форме, я опубликую ее здесь)

Answer 3

Вы можете создать шаблон слова (просто используйте функцию Сохранить как ... в Word).

первый вариант

Шаблон теперь содержит ряд дополнительных файлов XML в папке \ word : - styles.xml - stylesWithEffects.xml - webSettings.xml - fontTable.xml и - \ папка темы

Если вы скопируете эти файлы в исходный файл, сгенерированный POI, вы можете ссылаться на стили, указанные в файле styles.xml .

Вы можете манипулировать своим исходным файлом, как ZIP-файл, это не должно потребовать особых усилий.

второй вариант

Копирование стилей в коде из шаблона в ваш документ:

XWPFDocument template = new XWPFDocument(new FileInputStream(new File("Template.dotx")));       

XWPFDocument doc = new XWPFDocument();      
// let's copy styles from template to new doc
XWPFStyles newStyles = doc.createStyles();
newStyles.setStyles(template.getStyle());


XWPFParagraph para = doc.createParagraph();
para.setStyle("Heading1");

XWPFRun run = para.createRun();
run.setText("Heading 1");

return doc;

С положительной стороны вы можете управлять своими стилями по отдельности, используя Word и сохраняя их обратно в файл шаблона.

Answer 4

Да, вы должны сделать это вручную. В спецификации Docx сказано, что styles.xml, который содержит информацию о стилях, является необязательным. Итак, я почти уверен, что POI не создаст его вообще, если вы не сделаете это явно. Вы можете проверить это: просто распакуйте файл docx и посмотрите, есть этот файл или нет (yourfile.docx / word / styles.xml).

Итак, что вы должны сделать (в терминах docx, я не знаю, как это реализовано в POI):

1) создайте styles.xml и добавьте туда необходимые стили

2) создать отношения, которые соединяют document.xml и styles.xml (я думаю, что POI должен делать это автоматически)

3) использовать идентификаторы стилей внутри document.xml для соединения конкретной текстовой части (в терминах docx) с конкретным стилем.