Форматирование текста PDF в Java
Aspose.PDF for Java предлагает средства управления форматированием текста для интервалов, списков, примечаний, встроенного макета и многоколоночного оформления.
Установка простого межстрочного интервала
Используйте этот пример, когда текст абзаца должен использовать фиксированное значение межстрочного интервала.
- Создайте новый документ PDF и добавьте страницу.
- Загрузите или подготовьте исходный текст и создайте объект
TextFragment. - Установите межстрочный интервал, добавьте фрагмент на страницу и сохраните документ.
public static void specifyLineSpacingSimpleCase(Path outputFile) throws Exception {
try (Document document = new Document()) {
Page page = document.getPages().add();
Path loremPath = dataDir.resolve("lorem.txt");
String text = Files.exists(loremPath) ? Files.readString(loremPath) : "Lorem ipsum text not found.";
TextFragment textFragment = new TextFragment(text);
textFragment.getTextState().setFontSize(12);
textFragment.getTextState().setLineSpacing(16);
page.getParagraphs().add(textFragment);
document.save(outputFile.toString());
}
}
Сравнение режимов межстрочного интервала с пользовательским шрифтом
Используйте этот пример, когда необходимо протестировать межстрочный интервал с разными режимами форматирования для одного и того же шрифта.
- Создайте новый документ PDF и добавьте страницу.
- Загрузите пользовательский шрифт и подготовьте два фрагмента с разными режимами межстрочного интервала.
- Добавьте оба фрагмента на страницу и сохраните PDF.
public static void specifyLineSpacingSpecificCase(Path outputFile) throws Exception {
try (Document document = new Document()) {
Page page = document.getPages().add();
Path fontFile = dataDir.resolve("HPSimplified.ttf");
Path loremPath = dataDir.resolve("lorem.txt");
String text = Files.exists(loremPath) ? Files.readString(loremPath) : "Lorem ipsum text not found.";
try (InputStream fontStream = Files.newInputStream(fontFile)) {
Font font = FontRepository.openFont(fontStream, FontTypes.TTF);
TextFragment fragment1 = new TextFragment(text);
fragment1.getTextState().setFont(font);
fragment1.getTextState().setFormattingOptions(new TextFormattingOptions());
fragment1.getTextState().getFormattingOptions().setLineSpacing(TextFormattingOptions.LineSpacingMode.FontSize);
page.getParagraphs().add(fragment1);
TextFragment fragment2 = new TextFragment(text);
fragment2.getTextState().setFont(font);
fragment2.getTextState().setFormattingOptions(new TextFormattingOptions());
fragment2.getTextState().getFormattingOptions().setLineSpacing(TextFormattingOptions.LineSpacingMode.FullSize);
page.getParagraphs().add(fragment2);
}
document.save(outputFile.toString());
}
}
Установка межсимвольного интервала с помощью фрагментов текста
Используйте этот пример, когда один и тот же текст должен отображаться с разными значениями межбуквенного интервала.
- Создайте новый документ PDF и добавьте страницу.
- Создайте текстовые фрагменты с помощью вспомогательного метода для нескольких значений интервала.
- Добавьте фрагменты на страницу и сохраните документ.
public static void characterSpacingUsingTextFragment(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
page.getParagraphs().add(makeCharacterSpacingFragment(2.0f));
page.getParagraphs().add(makeCharacterSpacingFragment(1.0f));
page.getParagraphs().add(makeCharacterSpacingFragment(0.75f));
document.save(outputFile.toString());
}
}
private static TextFragment makeCharacterSpacingFragment(float spacing) {
TextFragment fragment = new TextFragment("Sample Text with character spacing");
fragment.getTextState().setFont(FontRepository.findFont("Arial"));
fragment.getTextState().setFontSize(14);
fragment.getTextState().setCharacterSpacing(spacing);
return fragment;
}
Задание межсимвольного интервала внутри текстового абзаца
Используйте этот пример, когда необходимо применить межсимвольный интервал внутри ограниченного текста абзаца.
- Создайте новый документ PDF и добавьте страницу.
- Создайте
TextParagraphс целевым прямоугольником и параметрами обтекания. - Добавьте стилизованный фрагмент текста и сохраните PDF.
public static void characterSpacingUsingTextParagraph(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextBuilder builder = new TextBuilder(page);
TextParagraph paragraph = new TextParagraph();
paragraph.setRectangle(new Rectangle(100, 700, 500, 750, true));
paragraph.getFormattingOptions().setWrapMode(TextFormattingOptions.WordWrapMode.ByWords);
TextFragment fragment = new TextFragment("Sample Text with character spacing");
fragment.getTextState().setFont(FontRepository.findFont("Arial"));
fragment.getTextState().setFontSize(14);
fragment.getTextState().setCharacterSpacing(2.0f);
paragraph.appendLine(fragment);
builder.appendParagraph(paragraph);
document.save(outputFile.toString());
}
}
Создание маркированного списка с помощью HTML
Используйте этот пример, когда из разметки HTML необходимо создать форматирование ненумерованного списка.
- Создайте новый документ PDF и добавьте страницу.
- Создайте строку HTML‑списка.
- Добавьте его как
HtmlFragmentи сохраните документ.
public static void createBulletListHtmlVersion(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
String htmlList = "<ul><li>First item in the list</li>"
+ "<li>Second item with more text to demonstrate wrapping behavior.</li>"
+ "<li>Third item</li><li>Fourth item</li></ul>";
page.getParagraphs().add(new HtmlFragment(htmlList));
document.save(outputFile.toString());
}
}
Создание нумерованного списка с помощью HTML
Используйте этот пример, когда необходимо вывести форматирование нумерованного списка из HTML‑разметки.
- Создайте новый документ PDF и добавьте страницу.
- Создайте строку упорядоченного HTML‑списка.
- Добавьте его как
HtmlFragmentи сохраните документ.
public static void createNumberedListHtmlVersion(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
String htmlList = "<ol><li>First item in the list</li>"
+ "<li>Second item with more text to demonstrate wrapping behavior.</li>"
+ "<li>Third item</li><li>Fourth item</li></ol>";
page.getParagraphs().add(new HtmlFragment(htmlList));
document.save(outputFile.toString());
}
}
Создание маркированного списка с LaTeX
Используйте этот пример, когда форматирование ненумерованного списка должно быть преобразовано из разметки TeX.
- Создайте новый документ PDF и добавьте страницу.
- Подготовьте строку списка TeX с окружением
itemize. - Добавьте это как
TeXFragmentи сохраните PDF.
public static void createBulletListLatexVersion(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
String texList = "Lists are easy to create: \\begin{itemize}"
+ "\\item First item"
+ "\\item Second item with more text to demonstrate wrapping behavior."
+ "\\item Third item"
+ "\\item Fourth item"
+ "\\end{itemize}";
page.getParagraphs().add(new TeXFragment(texList));
document.save(outputFile.toString());
}
}
Создание нумерованного списка с помощью LaTeX
Используйте этот пример, когда нумерованный список должен быть отформатирован из разметки TeX.
- Создайте новый документ PDF и добавьте страницу.
- Подготовьте строку списка TeX с окружением
enumerate. - Добавьте это как
TeXFragmentи сохраните PDF.
public static void createNumberedListLatexVersion(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
String texList = "Lists are easy to create: \\begin{enumerate}"
+ "\\item First item"
+ "\\item Second item with more text to demonstrate wrapping behavior."
+ "\\item Third item"
+ "\\item Fourth item"
+ "\\end{enumerate}";
page.getParagraphs().add(new TeXFragment(texList));
document.save(outputFile.toString());
}
}
Создание маркированного списка с текстовыми абзацами
Используйте этот пример, когда необходимо создать ручной маркированный список из фрагментов обычного текста.
- Создайте новый документ PDF и добавьте страницу.
- Создайте
TextParagraphи добавьте фрагменты с префиксом‑маркером. - Добавьте абзац на страницу и сохраните документ.
public static void createBulletList(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
String[] items = {
"First item in the list",
"Second item with more text to demonstrate wrapping behavior.",
"Third item",
"Fourth item"
};
TextBuilder builder = new TextBuilder(page);
TextParagraph paragraph = new TextParagraph();
paragraph.setRectangle(new Rectangle(80, 200, 400, 800, true));
paragraph.getFormattingOptions().setWrapMode(TextFormattingOptions.WordWrapMode.ByWords);
for (String item : items) {
TextFragment fragment = new TextFragment("- " + item);
fragment.getTextState().setFont(FontRepository.findFont("Times New Roman"));
fragment.getTextState().setFontSize(12);
paragraph.appendLine(fragment);
}
builder.appendParagraph(paragraph);
document.save(outputFile.toString());
}
}
Создание нумерованного списка с абзацами текста
Используйте этот пример, когда необходимо построить ручной нумерованный список из простых текстовых фрагментов.
- Создайте новый документ PDF и добавьте страницу.
- Создайте
TextParagraphи добавьте пронумерованные фрагменты. - Добавьте абзац на страницу и сохраните документ.
public static void createNumberedList(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
String[] items = {
"First item in the list",
"Second item with more text to demonstrate wrapping behavior.",
"Third item",
"Fourth item"
};
TextBuilder builder = new TextBuilder(page);
TextParagraph paragraph = new TextParagraph();
paragraph.setRectangle(new Rectangle(80, 200, 400, 800, true));
paragraph.getFormattingOptions().setWrapMode(TextFormattingOptions.WordWrapMode.ByWords);
for (int i = 0; i < items.length; i++) {
TextFragment fragment = new TextFragment((i + 1) + ". " + items[i]);
fragment.getTextState().setFont(FontRepository.findFont("Times New Roman"));
fragment.getTextState().setFontSize(12);
paragraph.appendLine(fragment);
}
builder.appendParagraph(paragraph);
document.save(outputFile.toString());
}
}
Добавление простой сноски
Используйте этот пример, когда фрагмент текста должен ссылаться на простую сноску.
- Создайте новый документ PDF и добавьте страницу.
- Создайте основной фрагмент текста и назначьте
Noteв виде сноски. - Добавьте последующий встроенный текст и сохраните документ.
public static void addFootnote(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment("This is a sample text with a footnote.");
textFragment.getTextState().setFont(FontRepository.findFont("Arial"));
textFragment.getTextState().setFontSize(14);
textFragment.setFootNote(new Note("This is the footnote content."));
page.getParagraphs().add(textFragment);
TextFragment inlineText = new TextFragment(" This is another text after footnote in the same paragraph.");
inlineText.setInLineParagraph(true);
inlineText.getTextState().setFont(FontRepository.findFont("Arial"));
inlineText.getTextState().setFontSize(14);
page.getParagraphs().add(inlineText);
document.save(outputFile.toString());
}
}
Добавление сноски с пользовательским стилем текста
Используйте этот пример, когда содержание сноски должно использовать собственные настройки шрифта, размера и цвета.
- Создайте новый документ PDF и добавьте страницу.
- Создайте основной фрагмент текста и настройте стилизованную сноску.
- Прикрепите заметку и сохраните PDF.
public static void addFootnoteCustomTextStyle(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment("This is a sample text with a footnote.");
textFragment.getTextState().setFont(FontRepository.findFont("Arial"));
textFragment.getTextState().setFontSize(14);
Note note = new Note("This is the footnote content with custom text style.");
TextState noteTextState = new TextState();
noteTextState.setFont(FontRepository.findFont("Times New Roman"));
noteTextState.setFontSize(10);
noteTextState.setForegroundColor(Color.getRed());
noteTextState.setFontStyle(FontStyles.Italic);
note.setTextState(noteTextState);
textFragment.setFootNote(note);
page.getParagraphs().add(textFragment);
document.save(outputFile.toString());
}
}
Добавление сноски с пользовательским текстом маркера
Используйте этот пример, когда видимый маркер сноски должен быть заменён пользовательским текстом.
- Создайте новый документ PDF и добавьте страницу.
- Назначьте сноску основному фрагменту текста и переопределите её маркерный текст.
- Добавьте оставшийся контент и сохраните документ.
public static void addFootnoteCustomText(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment("This is a sample text with a footnote.");
textFragment.getTextState().setFont(FontRepository.findFont("Arial"));
textFragment.getTextState().setFontSize(14);
textFragment.setFootNote(new Note("This is the footnote content."));
textFragment.getFootNote().setText("***");
page.getParagraphs().add(textFragment);
TextFragment anotherText = new TextFragment(" This is another text without footnote.");
anotherText.getTextState().setFont(FontRepository.findFont("Arial"));
anotherText.getTextState().setFontSize(14);
page.getParagraphs().add(anotherText);
document.save(outputFile.toString());
}
}
Настройка разделительной линии сноски
Используйте этот пример, когда линия, отделяющая сноски от содержимого страницы, должна быть явно оформлена.
- Создайте новый документ PDF и добавьте страницу.
- Настройте стиль линии заметки страницы через
GraphInfo. - Добавьте фрагменты текста со сносками и сохраните документ.
public static void addFootnoteWithCustomLineStyle(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
GraphInfo graphInfo = new GraphInfo();
graphInfo.setLineWidth(2);
graphInfo.setColor(Color.getRed());
graphInfo.setDashArray(new int[] {3});
graphInfo.setDashPhase(1);
page.setNoteLineStyle(graphInfo);
TextFragment text1 = new TextFragment("This is a sample text with a footnote.");
text1.setFootNote(new Note("foot note for text 1"));
page.getParagraphs().add(text1);
TextFragment text2 = new TextFragment("This is yet another sample text with a footnote.");
text2.setFootNote(new Note("foot note for text 2"));
page.getParagraphs().add(text2);
document.save(outputFile.toString());
}
}
Добавление сноски с изображением и содержимым таблицы
Используйте этот пример, когда примечание само должно содержать насыщенный контент, такой как изображения, текст и таблицы.
- Создайте новый документ PDF и добавьте страницу.
- Создайте объект
Noteс изображением, встроенным текстом и таблицей. - Прикрепите его к основному текстовому фрагменту и сохраните документ.
public static void addFootnoteWithImageAndTable(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment text = new TextFragment("This is a sample text with a footnote.");
page.getParagraphs().add(text);
Note note = new Note();
Image imageNote = new Image();
imageNote.setFile(dataDir.resolve("logo.jpg").toString());
imageNote.setFixHeight(20);
imageNote.setFixWidth(20);
note.getParagraphs().add(imageNote);
TextFragment textNote = new TextFragment("This is the footnote content.");
textNote.getTextState().setFontSize(20);
textNote.setInLineParagraph(true);
note.getParagraphs().add(textNote);
Table table = new Table();
table.getRows().add().getCells().add("Cell 1,1");
table.getRows().add().getCells().add("Cell 1,2");
note.getParagraphs().add(table);
text.setFootNote(note);
document.save(outputFile.toString());
}
}
Добавление концевой сноски
Используйте этот пример, когда фрагмент текста должен ссылаться на содержание сноски в конце, а не на сноску на странице.
- Создайте новый документ PDF и добавьте страницу.
- Назначьте концевую сноску основному фрагменту текста и добавьте сопутствующий основной текст.
- Сохраните документ с сгенерированным содержимым сноски.
public static void addEndnote(Path outputFile) throws Exception {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment("This is a sample text with an endnote.");
textFragment.getTextState().setFont(FontRepository.findFont("Arial"));
textFragment.getTextState().setFontSize(14);
textFragment.setEndNote(new Note("This is the EndNote content."));
page.getParagraphs().add(textFragment);
String textContent = loremText();
for (int i = 0; i < 5; i++) {
TextFragment text = new TextFragment(textContent);
text.getTextState().setFont(FontRepository.findFont("Arial"));
text.getTextState().setFontSize(14);
page.getParagraphs().add(text);
}
document.save(outputFile.toString());
}
}
private static String loremText() throws Exception {
Path loremPath = dataDir.resolve("lorem.txt");
return Files.exists(loremPath) ? Files.readString(loremPath) : "Lorem ipsum sample text not found.";
}
Добавление концевой сноски с пользовательским текстом маркера
Используйте этот пример, когда маркер сноски должен использовать пользовательскую видимую метку.
- Создайте новый документ PDF и добавьте страницу.
- Назначьте концевую сноску основному фрагменту текста и переопределите её маркерный текст.
- Добавьте оставшийся текст документа и сохраните PDF.
public static void addEndnoteCustomText(Path outputFile) throws Exception {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment("This is a sample text with an endnote.");
textFragment.getTextState().setFont(FontRepository.findFont("Arial"));
textFragment.getTextState().setFontSize(14);
textFragment.setEndNote(new Note("This is the EndNote content."));
textFragment.getEndNote().setText("***");
page.getParagraphs().add(textFragment);
String textContent = loremText();
for (int i = 0; i < 5; i++) {
TextFragment text = new TextFragment(textContent);
text.getTextState().setFont(FontRepository.findFont("Arial"));
text.getTextState().setFontSize(14);
page.getParagraphs().add(text);
}
document.save(outputFile.toString());
}
}
Принудительное размещение содержимого таблиц на новой странице
Используйте этот пример, когда форматированный контент должен явно начинаться с новой страницы.
- Создайте новый документ PDF и добавьте страницу.
- Создайте таблицу и заполните её строки.
- Установите таблицу так, чтобы она начиналась на новой странице, и сохраните документ.
public static void forceNewPage(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
Table table = new Table();
table.setColumnWidths("150 150 150");
table.setDefaultCellBorder(new BorderInfo(BorderSide.All));
for (int i = 0; i < 5; i++) {
Row row = table.getRows().add();
row.getCells().add("Row " + (i + 1) + " - Col 1");
row.getCells().add("Row " + (i + 1) + " - Col 2");
row.getCells().add("Row " + (i + 1) + " - Col 3");
}
table.setInNewPage(true);
page.getParagraphs().add(table);
document.save(outputFile.toString());
}
}
Смешивание встроенного контента внутри одного абзаца
Используйте этот пример, когда текст и изображения должны продолжаться в том же потоке абзаца.
- Создайте новый документ PDF и добавьте страницу.
- Добавьте первый фрагмент текста, затем встроенное изображение, затем ещё один встроенный фрагмент текста.
- Добавьте любой следующий отдельный абзац и сохраните документ.
public static void usingInlineParagraphProperty(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment fragment1 = new TextFragment("This is the first part of the paragraph. ");
fragment1.getTextState().setFont(FontRepository.findFont("Arial"));
fragment1.getTextState().setFontSize(14);
page.getParagraphs().add(fragment1);
Image image = new Image();
image.setInLineParagraph(true);
image.setFile(dataDir.resolve("logo.jpg").toString());
image.setFixHeight(30);
image.setFixWidth(30);
page.getParagraphs().add(image);
TextFragment fragment2 = new TextFragment("This is the second part of the same paragraph.");
fragment2.setInLineParagraph(true);
fragment2.getTextState().setFont(FontRepository.findFont("Arial"));
fragment2.getTextState().setFontSize(14);
page.getParagraphs().add(fragment2);
TextFragment fragment3 = new TextFragment("This is a new paragraph.");
fragment3.getTextState().setFont(FontRepository.findFont("Arial"));
fragment3.getTextState().setFontSize(14);
page.getParagraphs().add(fragment3);
document.save(outputFile.toString());
}
}
Создание макета текста с несколькими колонками
Используйте этот пример, когда текст в стиле статьи должен протекать через несколько колонок.
- Создайте новый PDF‑документ и настройте поля страницы.
- Добавьте содержимое заголовка и создайте многоколоночный
FloatingBox. - Заполните его текстом и сохраните окончательный PDF.
public static void createMultiColumnPdf(Path outputFile) throws Exception {
try (Document document = new Document()) {
document.getPageInfo().getMargin().setLeft(40);
document.getPageInfo().getMargin().setRight(40);
Page page = document.getPages().add();
com.aspose.pdf.drawing.Graph graph1 = new com.aspose.pdf.drawing.Graph(500.0, 2.0);
page.getParagraphs().add(graph1);
graph1.getShapes().addItem(new com.aspose.pdf.drawing.Line(new float[] {1.0f, 2.0f, 500.0f, 2.0f}));
String html = "<span style=\"font-family: 'Times New Roman'; font-size: 18px;\"><strong>How to Steer Clear of money scams</strong></span>";
page.getParagraphs().add(new HtmlFragment(html));
FloatingBox box = new FloatingBox();
box.getColumnInfo().setColumnCount(2);
box.getColumnInfo().setColumnSpacing("5");
box.getColumnInfo().setColumnWidths("105 105");
TextFragment text1 = new TextFragment("By A Googler (The Official Google Blog)");
text1.getTextState().setFontSize(8);
text1.getTextState().setLineSpacing(2);
box.getParagraphs().add(text1);
text1.getTextState().setFontSize(10);
text1.getTextState().setFontStyle(FontStyles.Italic);
com.aspose.pdf.drawing.Graph graph2 = new com.aspose.pdf.drawing.Graph(50.0, 10.0);
graph2.getShapes().addItem(new com.aspose.pdf.drawing.Line(new float[] {1.0f, 10.0f, 100.0f, 10.0f}));
box.getParagraphs().add(graph2);
String loremText = loremText();
box.getParagraphs().add(new TextFragment(loremText.repeat(5)));
page.getParagraphs().add(box);
document.save(outputFile.toString());
}
}
Создание выровненного текста с пользовательскими табуляциями
Используйте этот пример, когда текст должен выравниваться как простая таблица, используя позиции табуляции.
- Создайте новый документ PDF и добавьте страницу.
- Настройте позиции табуляции с параметрами выравнивания и заполнителя.
- Создайте текстовые фрагменты, использующие эти табуляции, и сохраните документ.
public static void customTabStops(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TabStops tabStops = new TabStops();
TabStop tabStop1 = tabStops.add(100);
tabStop1.setAlignmentType(TabAlignmentType.Right);
tabStop1.setLeaderType(TabLeaderType.Solid);
TabStop tabStop2 = tabStops.add(200);
tabStop2.setAlignmentType(TabAlignmentType.Center);
tabStop2.setLeaderType(TabLeaderType.Dash);
TabStop tabStop3 = tabStops.add(300);
tabStop3.setAlignmentType(TabAlignmentType.Left);
tabStop3.setLeaderType(TabLeaderType.Dot);
TextFragment header = new TextFragment("This is an example of forming table with TAB stops", tabStops);
TextFragment text0 = new TextFragment("#$TABHead1 #$TABHead2 #$TABHead3", tabStops);
TextFragment text1 = new TextFragment("#$TABdata11 #$TABdata12 #$TABdata13", tabStops);
TextFragment text2 = new TextFragment("#$TABdata21 ", tabStops);
text2.getSegments().add(new TextSegment("#$TAB"));
text2.getSegments().add(new TextSegment("data22 "));
text2.getSegments().add(new TextSegment("#$TAB"));
text2.getSegments().add(new TextSegment("data23"));
page.getParagraphs().add(header);
page.getParagraphs().add(text0);
page.getParagraphs().add(text1);
page.getParagraphs().add(text2);
document.save(outputFile.toString());
}
}