Как я могу использовать предопределенные форматы в DOCX с POI?
Я создаю генератор docx с POI и хотел бы использовать предопределенные форматы.
Word включает в себя несколько форматов, таких как Заголовок, Заголовок 1..10 и т. Д. Эти форматы предопределены в каждом DOCX, который вы создаете с помощью Word.
Я хотел бы использовать их в моем генераторе документов. Я попробовал следующее, но формат не был применен:
paragraph = document.createParagraph();
lastParagraph.setStyle("Heading1");
Я также попробовал "заголовок 1", "заголовок1" и "заголовок1" как стиль, но ни один из них не сработал.
Документация API не содержит никаких подробностей.
Я проанализировал файл docx, созданный в Word 2007, и обнаружил, что "Heading1" будет правильным. К сожалению, стиль не определен в docx. Нужно ли создавать этот стиль вручную?
Кто-нибудь может указать мне правильное решение?
4 ответа
Все очень просто: используйте файл шаблона "docx".
- Создайте пустой файл DOCX с Word 2007.
- Используйте этот файл в качестве шаблона для вашего
XWPFDocument
- Добавьте свои абзацы со стилями.
Вот код:
XWPFDocument document = new XWPFDocument(new FileInputStream("template.docx");
paragraph = document.createParagraph();
paragraph.setStyle("Heading1");
Шаблон содержит все стили и поэтому на них можно ссылаться через setStyle("Heading1");
,
Если вы, как правило, заинтересованы в создании стиля, который распознается как заголовок уровня 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.
(Я знаю: это не прямой ответ на ваш вопрос, но, поскольку я не нашел эту информацию в Интернете в удобной форме, я опубликую ее здесь)
Вы можете создать шаблон слова (просто используйте функцию Сохранить как... в Word).
первый вариант
Шаблон теперь содержит несколько дополнительных файлов XML в папке \word: - styles.xml - stylesWithEffects.xml - webSettings.xml - fontTable.xml и папку - \theme
Если вы скопируете эти файлы в исходный файл, сгенерированный 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 и сохраняя их обратно в файл шаблона.
Да, вы должны сделать это вручную. В спецификации 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) с конкретным стилем.