Adicionar texto ao PDF em Java
Aspose.PDF for Java suporta inserção de texto simples, layout avançado, estilização, gradientes, HTML, LaTeX e fontes personalizadas.
Adicionar um fragmento de texto simples
Use este exemplo quando uma string curta de texto deve ser posicionada em coordenadas fixas da página.
- Crie um novo documento PDF e adicione uma página.
- Crie um
TextFragmente defina sua posição. - Adicione-o à página e salve o documento.
public static void addTextSimpleCase(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment("Hello, Aspose!");
textFragment.setPosition(new Position(100, 600));
page.getParagraphs().add(textFragment);
document.save(outputFile.toString());
}
}
Adicionar um parágrafo dentro de um retângulo
Use este exemplo quando um bloco maior de texto deve ser ajustado dentro de uma área delimitada.
- Crie um novo documento PDF e adicione uma página.
- Carregue o texto de origem e configure um
TextParagraphretângulo e modo de quebra. - Anexe o fragmento através
TextBuildere salve o PDF.
public static void addParagraph(Path outputFile) throws Exception {
try (Document document = new Document()) {
Page page = document.getPages().add();
String text = Files.exists(loremPath)
? Files.readString(loremPath)
: "Lorem ipsum sample text not found.";
TextBuilder builder = new TextBuilder(page);
TextParagraph paragraph = new TextParagraph();
paragraph.setFirstLineIndent(20);
paragraph.setRectangle(new Rectangle(80, 800, 400, 200, true));
paragraph.getFormattingOptions().setWrapMode(TextFormattingOptions.WordWrapMode.DiscretionaryHyphenation);
TextFragment fragment = new TextFragment(text);
fragment.getTextState().setFont(FontRepository.findFont("Times New Roman"));
fragment.getTextState().setFontSize(12);
paragraph.appendLine(fragment);
builder.appendParagraph(paragraph);
document.save(outputFile.toString());
}
}
Adicionar parágrafos com diferentes configurações de recuo
Use este exemplo quando a primeira linha e as linhas subsequentes devem usar regras de recuo diferentes.
- Crie um novo documento PDF e adicione uma página.
- Prepare o fragmento de texto compartilhado e crie múltiplos objetos
TextParagraph. - Configure a identação de cada parágrafo, anexe-os e salve o documento.
public static void addParagraphsIndents(Path outputFile) throws Exception {
try (Document document = new Document()) {
Page page = document.getPages().add();
String text = Files.exists(loremPath)
? Files.readString(loremPath)
: "Lorem ipsum sample text not found.";
TextFragment fragment = new TextFragment(text);
fragment.getTextState().setFont(FontRepository.findFont("Times New Roman"));
fragment.getTextState().setFontSize(12);
TextBuilder builder = new TextBuilder(page);
TextParagraph paragraph1 = new TextParagraph();
paragraph1.setFirstLineIndent(20);
paragraph1.setRectangle(new Rectangle(80, 800, 300, 50, true));
paragraph1.getFormattingOptions().setWrapMode(TextFormattingOptions.WordWrapMode.ByWords);
paragraph1.appendLine(fragment);
builder.appendParagraph(paragraph1);
TextParagraph paragraph2 = new TextParagraph();
paragraph2.setSubsequentLinesIndent(20);
paragraph2.setRectangle(new Rectangle(320, 800, 500, 50, true));
paragraph2.getFormattingOptions().setWrapMode(TextFormattingOptions.WordWrapMode.ByWords);
paragraph2.appendLine(fragment);
builder.appendParagraph(paragraph2);
document.save(outputFile.toString());
}
}
Inserir texto com uma quebra de linha manual
Use este exemplo quando um fragmento de texto deve conter uma nova linha explícita.
- Crie um novo documento PDF e adicione uma página.
- Crie um
TextFragmentcontendo uma quebra de linha e configure seu estilo. - Anexe-o através de um
TextParagraphe salve o PDF.
public static void addNewLine(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment("Applicant Name: " + System.lineSeparator() + " Joe Smoe");
textFragment.getTextState().setFontSize(12);
textFragment.getTextState().setFont(FontRepository.findFont("TimesNewRoman"));
textFragment.getTextState().setBackgroundColor(Color.getLightGray());
textFragment.getTextState().setForegroundColor(Color.getRed());
TextParagraph paragraph = new TextParagraph();
paragraph.appendLine(textFragment);
paragraph.setPosition(new Position(100, 600));
TextBuilder textBuilder = new TextBuilder(page);
textBuilder.appendParagraph(paragraph);
document.save(outputFile.toString());
}
}
Inspecionar quebras de linha detectadas
Use este exemplo quando precisar revisar a saída de notificação relacionada ao layout de texto e à quebra de linha.
- Crie um novo documento PDF e habilite o registro de notificações.
- Adicione vários fragmentos de texto longos à página.
- Inspecione as notificações e salve o documento.
public static void determineLineBreak(Path outputFile) {
try (Document document = new Document()) {
document.setEnableNotificationLogging(true);
Page page = document.getPages().add();
for (int i = 0; i < 4; i++) {
TextFragment text = new TextFragment(
"Lorem ipsum \r\ndolor sit amet, consectetur adipiscing elit, "
+ "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. "
+ "Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris "
+ "nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in "
+ "reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla "
+ "pariatur. Excepteur sint occaecat cupidatat non proident, sunt in "
+ "culpa qui officia deserunt mollit anim id est laborum.");
text.getTextState().setFontSize(20);
page.getParagraphs().add(text);
}
System.out.println(document.getPages().get_Item(1).getNotifications());
document.save(outputFile.toString());
}
}
Medir largura do texto dinamicamente
Use este exemplo quando as larguras de caracteres e de strings devem ser medidas antes de decisões de layout serem tomadas.
- Resolva a fonte de destino e crie um
TextState. - Meça os caracteres e compare os resultados das APIs de Font e de estado de texto.
- Exiba quaisquer divergências para validação.
public static void getTextWidthDynamically(Path outputFile) {
Font font = FontRepository.findFont("Arial");
TextState textState = new TextState();
textState.setFont(font);
textState.setFontSize(14);
if (Math.abs(font.measureString("A", 14) - 9.337) > 0.001) {
System.out.println("Unexpected font string measure!");
}
if (Math.abs(textState.measureString("z") - 7.0) > 0.001) {
System.out.println("Unexpected font string measure!");
}
for (char c = 'A'; c <= 'z'; c++) {
double fontMeasure = font.measureString(String.valueOf(c), 14);
double textStateMeasure = textState.measureString(String.valueOf(c));
if (Math.abs(fontMeasure - textStateMeasure) > 0.001) {
System.out.println("Font and state string measuring doesn't match!");
}
}
}
Adicionar texto com um segmento de hiperlink
Use este exemplo quando uma parte de um fragmento de texto deve se comportar como um link da web.
- Crie um novo documento PDF e adicione uma página.
- Construa um
TextFragmentcom vários objetosTextSegment. - Atribua um hiperlink e estilo ao segmento de destino, então salve o documento.
public static void addTextWithHyperlink(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment fragment = new TextFragment("Sample Text Fragment");
fragment.getSegments().add(new TextSegment(" ... Text Segment 1..."));
TextSegment segment = new TextSegment("Link to Aspose");
fragment.getSegments().add(segment);
segment.setHyperlink(new WebHyperlink("https://products.aspose.com/pdf"));
segment.getTextState().setForegroundColor(Color.getBlue());
segment.getTextState().setFontStyle(FontStyles.Italic);
fragment.getSegments().add(new TextSegment("TextSegment without hyperlink"));
page.getParagraphs().add(fragment);
document.save(outputFile.toString());
}
}
Adicionar texto da direita para a esquerda
Use este exemplo quando o documento precisar exibir conteúdo de script da direita para a esquerda com o alinhamento adequado.
- Crie um novo documento PDF e adicione uma página.
- Crie um
TextFragmentcom o texto RTL de destino e configure sua fonte e alinhamento. - Adicione-o à página e salve o PDF.
public static void addTextWithRtlText(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment(
"يعتبر خوجا نصر الدين شخصية فولكلورية من الشرق الإسلامي وبعض شعوب البحر الأبيض المتوسط والبلقان، وهو بطل القصص والحكايات القصيرة الفكاهية والساخرة، وأحيانًا الحكايات اليومية.");
textFragment.getTextState().setFont(FontRepository.findFont("Tahoma"));
textFragment.getTextState().setFontSize(14);
textFragment.getTextState().setForegroundColor(Color.getBlue());
textFragment.setHorizontalAlignment(HorizontalAlignment.Right);
page.getParagraphs().add(textFragment);
document.save(outputFile.toString());
}
}
Adicionar texto estilizado e segmentos semelhantes a fórmulas
Use este exemplo quando o texto normal e segmentos semelhantes a subscrito devem usar diferentes estados de texto em uma única saída.
- Crie um novo documento PDF e adicione uma página.
- Construa o fragmento principal estilizado e componha a fórmula com segmentos auxiliares.
- Adicione ambos os fragmentos à página e salve o documento.
public static void addTextWithFontStyling(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment formula = new TextFragment();
TextFragment textFragment = new TextFragment("Hello, Aspose!");
textFragment.setPosition(new Position(100, 600));
textFragment.getTextState().setFont(FontRepository.findFont("Arial"));
textFragment.getTextState().setFontSize(14);
textFragment.getTextState().setForegroundColor(Color.getBlue());
textFragment.getTextState().setFontStyle(FontStyles.Bold | FontStyles.Italic);
textFragment.getTextState().setUnderline(true);
textFragment.setHorizontalAlignment(HorizontalAlignment.Left);
TextState textStateLetters = new TextState();
textStateLetters.setFont(FontRepository.findFont("Arial"));
textStateLetters.setFontSize(14);
textStateLetters.setForegroundColor(Color.getBlue());
textStateLetters.setFontStyle(FontStyles.Bold);
TextState textStateIndex = new TextState();
textStateIndex.setFont(FontRepository.findFont("Arial"));
textStateIndex.setFontSize(14);
textStateIndex.setForegroundColor(Color.getDarkRed());
textStateIndex.setSubscript(true);
Position position = new Position(100, 500);
addSegment(formula, "S = a", textStateLetters, position);
addSegment(formula, "2n", textStateIndex, position);
addSegment(formula, " + a", textStateLetters, position);
addSegment(formula, "2n+1", textStateIndex, position);
addSegment(formula, " + a", textStateLetters, position);
addSegment(formula, "2n+2", textStateIndex, position);
formula.setHorizontalAlignment(HorizontalAlignment.Left);
page.getParagraphs().add(textFragment);
page.getParagraphs().add(formula);
document.save(outputFile.toString());
}
}
private static void addSegment(TextFragment formula, String text, TextState state, Position position) {
TextSegment segment = new TextSegment(text);
segment.setTextState(state);
segment.setPosition(position);
formula.getSegments().add(segment);
}
Adicionar texto sublinhado
Use este exemplo quando um fragmento de texto deve exibir estilização sublinhada.
- Crie um novo documento PDF e adicione uma página.
- Crie o TextFragment, configure sua Font e o estado de sublinhado, e defina sua posição.
- Anexe com
TextBuildere salve o resultado.
public static void addUnderlineText(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextBuilder textBuilder = new TextBuilder(page);
TextFragment fragment = new TextFragment("Hello, ASPOSE.PDF!");
fragment.getTextState().setFont(FontRepository.findFont("Arial"));
fragment.getTextState().setFontSize(10);
fragment.getTextState().setUnderline(true);
fragment.setPosition(new Position(10, 800));
textBuilder.appendText(fragment);
document.save(outputFile.toString());
}
}
Adicionar texto transparente sobre uma forma colorida
Use este exemplo quando o texto deve aparecer com transparência sobre um gráfico de fundo.
- Crie um novo documento PDF e adicione uma página.
- Desenhe a forma de fundo e crie um fragmento de texto semitransparente.
- Adicione ambos os elementos à página e salve o documento.
public static void addTextTransparent(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
com.aspose.pdf.drawing.Graph canvas = new com.aspose.pdf.drawing.Graph(100.0, 400.0);
com.aspose.pdf.drawing.Rectangle rectangle = new com.aspose.pdf.drawing.Rectangle(100, 100, 400, 400);
rectangle.getGraphInfo().setFillColor(Color.fromArgb(128, 0xC5, 0xB5, 0xFF));
canvas.getShapes().addItem(rectangle);
canvas.setChangePosition(false);
page.getParagraphs().add(canvas);
TextFragment text = new TextFragment(
"This is the transparent text. This is the transparent text. This is the transparent text.");
text.getTextState().setForegroundColor(Color.fromArgb(30, 0, 255, 0));
page.getParagraphs().add(text);
document.save(outputFile.toString());
}
}
Adicionar texto invisível
Use este exemplo quando texto pesquisável ou oculto deve estar presente sem renderização visível.
- Crie um novo documento PDF e adicione uma página.
- Adicione um fragmento de texto visível e um segundo fragmento com a flag invisível habilitada.
- Salve o documento.
public static void addTextInvisible(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment text1 = new TextFragment(
"This is the visible text. This is the visible text. This is the visible text.");
page.getParagraphs().add(text1);
TextFragment text2 = new TextFragment(
"This is the invisible text. This is the invisible text. This is the invisible text.");
text2.getTextState().setInvisible(true);
page.getParagraphs().add(text2);
document.save(outputFile.toString());
}
}
Adicionar texto com uma borda retangular
Use este exemplo quando o texto deve ser desenhado junto com seu retângulo delimitador.
- Crie um novo documento PDF e adicione uma página.
- Crie um estilizado
TextFragmente habilite o desenho da borda do retângulo de texto. - Anexe com
TextBuildere salve o PDF.
public static void addTextBorder(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment("This is sample text with border.");
textFragment.setPosition(new Position(10, 700));
textFragment.getTextState().setFont(FontRepository.findFont("Times New Roman"));
textFragment.getTextState().setFontSize(12);
textFragment.getTextState().setBackgroundColor(Color.getLightGray());
textFragment.getTextState().setForegroundColor(Color.getRed());
textFragment.getTextState().setStrokingColor(Color.getDarkRed());
textFragment.getTextState().setDrawTextRectangleBorder(true);
TextBuilder textBuilder = new TextBuilder(page);
textBuilder.appendText(textFragment);
document.save(outputFile.toString());
}
}
Adicionar texto tachado
Use este exemplo quando o texto deve usar formatação de tachado.
- Crie um novo documento PDF e adicione uma página.
- Crie um fragmento de texto estilizado com tachado habilitado.
- Anexe-o à página e salve o documento.
public static void addStrikeoutText(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment("This is sample strikeout text.");
textFragment.getTextState().setFontSize(12);
textFragment.getTextState().setFont(FontRepository.findFont("TimesNewRoman"));
textFragment.getTextState().setBackgroundColor(Color.getLightGray());
textFragment.getTextState().setForegroundColor(Color.getRed());
textFragment.getTextState().setStrikeOut(true);
textFragment.getTextState().setFontStyle(FontStyles.Bold);
textFragment.setPosition(new Position(100, 600));
TextBuilder textBuilder = new TextBuilder(page);
textBuilder.appendText(textFragment);
document.save(outputFile.toString());
}
}
Aplicar sombreamento de gradiente axial ao texto
Use este exemplo quando o texto deve usar um preenchimento de gradiente linear em vez de uma cor sólida.
- Crie um novo documento PDF e adicione uma página.
- Crie o TextFragment e atribua um gradiente axial à sua cor de primeiro plano.
- Adicione-o à página e salve o PDF.
public static void applyGradientAxialShadingToText(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment("PDF TITLE");
textFragment.setPosition(new Position(100, 600));
textFragment.getTextState().setFontSize(36);
textFragment.getTextState().setFont(FontRepository.findFont("Arial Bold"));
textFragment.getTextState().setForegroundColor(new Color());
textFragment.getTextState().getForegroundColor()
.setPatternColorSpace(new GradientAxialShading(Color.getRed(), Color.getBlue()));
textFragment.getTextState().setUnderline(true);
page.getParagraphs().add(textFragment);
document.save(outputFile.toString());
}
}
Aplicar sombreamento de gradiente radial ao texto
Use este exemplo quando o texto deve usar um preenchimento de gradiente radial.
- Crie um novo documento PDF e adicione uma página.
- Crie o fragmento de texto e atribua um gradiente radial à sua cor de primeiro plano.
- Adicione-o à página e salve o documento.
public static void applyGradientRadialShadingToText(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment textFragment = new TextFragment("PDF TITLE");
textFragment.setPosition(new Position(100, 600));
textFragment.getTextState().setFontSize(36);
textFragment.getTextState().setFont(FontRepository.findFont("Arial Bold"));
textFragment.getTextState().setForegroundColor(new Color());
textFragment.getTextState().getForegroundColor()
.setPatternColorSpace(new GradientRadialShading(Color.getRed(), Color.getBlue()));
textFragment.getTextState().setUnderline(true);
page.getParagraphs().add(textFragment);
document.save(outputFile.toString());
}
}
Adicionar texto formatado em estilo HTML inline
Use este exemplo quando a formatação de sobrescrito e subscrito deve ser inserida por meio de marcação HTML.
- Crie um novo documento PDF e adicione uma página.
- Crie um
HtmlFragmentcom a marcação inline necessária. - Adicione-o à página e salve o PDF.
public static void addTextHtmlFragment(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
HtmlFragment textFragment = new HtmlFragment("<pre>S=a<sub>2n</sub>+a<sup>2</sup><pre>");
page.getParagraphs().add(textFragment);
document.save(outputFile.toString());
}
}
Adicionar um fragmento de texto LaTeX
Use este exemplo quando conteúdo matemático ou formatado em TeX precisar ser renderizado dentro do PDF.
- Crie um novo documento PDF e adicione uma página.
- Crie um
TeXFragmentcom a expressão necessária. - Adicione-o à página e salve o documento.
public static void addTextLatexFragment(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
TeXFragment textFragment = new TeXFragment(
"\\underbrace{\\overbrace{a+b}^6 \\cdot \\overbrace{c+d}^7}_\\text{example of text} = 42");
page.getParagraphs().add(textFragment);
document.save(outputFile.toString());
}
}
Adicionar um fragmento HTML rico
Use este exemplo quando a página deve renderizar conteúdo HTML estruturado, como cabeçalhos, parágrafos e links.
- Crie um novo documento PDF e adicione uma página.
- Prepare a string de conteúdo HTML e crie um
HtmlFragment. - Adicione-o à página e salve o PDF.
public static void addHtmlFragment(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
String htmlContent = """
<h1 style='color:blue;'>Hello, Aspose!</h1>
<p>This is a sample paragraph with <b>bold</b>, <i>italic</i>, and <u>underlined</u> text.</p>
<p style='color:green;'>This paragraph is green.</p>
<a href='https://www.aspose.com' style='font-size:16px;'>Visit Aspose</a>
""";
HtmlFragment htmlFragment = new HtmlFragment(htmlContent);
page.getParagraphs().add(htmlFragment);
document.save(outputFile.toString());
}
}
Adicionar um HtmlFragment com estado de texto sobrescrito
Use este exemplo quando o conteúdo HTML importado deve herdar uma configuração controlada de fonte e cor.
- Crie um novo documento PDF e adicione uma página.
- Prepare o conteúdo HTML e crie o
HtmlFragment. - Atribua um personalizado
TextState, adicione o fragmento, e salve o documento.
public static void addHtmlFragmentOverrideTextState(Path outputFile) {
try (Document document = new Document()) {
Page page = document.getPages().add();
String htmlContent = """
<h1 style='color:blue;font-family:Verdana'>Hello, Aspose!</h1>
<p>This is a sample paragraph with <b>bold</b>, <i>italic</i>, and <u>underlined</u> text.</p>
<p style='color:green;'>This paragraph is green.</p>
<a href='https://www.aspose.com' style='font-size:16px;'>Visit Aspose</a>
""";
HtmlFragment htmlFragment = new HtmlFragment(htmlContent);
TextState textState = new TextState();
textState.setFont(FontRepository.findFont("Arial"));
textState.setFontSize(14);
textState.setForegroundColor(Color.getRed());
htmlFragment.setTextState(textState);
page.getParagraphs().add(htmlFragment);
document.save(outputFile.toString());
}
}
Usar uma fonte personalizada carregada de um arquivo
Use este exemplo quando o texto deve usar uma fonte carregada diretamente de um caminho de arquivo de fonte.
- Resolva o caminho do arquivo de fonte personalizado.
- Crie um fragmento de texto e carregue a fonte através
FontRepository.openFont. - Aplique as configurações de Font e salve o documento.
public static void useCustomFontFromFile(Path outputFile) {
Path fontPath = fontDir.resolve("BriosoPro Italic.otf");
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment fragment = new TextFragment("Hello, Aspose!");
fragment.setPosition(new Position(100, 600));
fragment.getTextState().setFont(FontRepository.openFont(fontPath.toString()));
fragment.getTextState().setFontSize(24);
fragment.getTextState().setForegroundColor(Color.getBlue());
fragment.getTextState().setFontStyle(FontStyles.Italic);
page.getParagraphs().add(fragment);
document.save(outputFile.toString());
}
}
Usar uma fonte personalizada carregada de um fluxo
Use este exemplo quando uma fonte personalizada deve ser aberta a partir de um stream e incorporada no PDF.
- Abra o arquivo de fonte como um fluxo e carregue-o com
FontRepository. - Crie o fragmento de texto e atribua a fonte incorporada.
- Adicione o fragmento à página e salve o documento.
public static void useCustomFontFromStream(Path outputFile) throws Exception {
Path fontPath = fontDir.resolve("BriosoPro Italic.otf");
try (InputStream fontStream = Files.newInputStream(fontPath)) {
Font font = FontRepository.openFont(fontStream, FontTypes.OTF);
font.setEmbedded(true);
try (Document document = new Document()) {
Page page = document.getPages().add();
TextFragment fragment = new TextFragment("Hello, Aspose!");
fragment.setPosition(new Position(100, 600));
fragment.getTextState().setFont(font);
fragment.getTextState().setFontSize(14);
fragment.getTextState().setForegroundColor(Color.getBlue());
fragment.getTextState().setFontStyle(FontStyles.Italic);
page.getParagraphs().add(fragment);
document.save(outputFile.toString());
}
}
}