Aspose.Slides FOSS
Java
Como formatar texto em Java

Como formatar texto em Java

Aspose.Slides FOSS for Java provides fine-grained text formatting through the PortionFormat classe A. Portion É a menor unidade independente de texto; ele mapeia para uma única formatação executada dentro de um parágrafo. Este guia mostra como aplicar o formato em negrito, itálico, tamanho da fonte e cor ao texto em uma apresentação.

Guia passo a passo

Passo 1: Adicionar a dependência Maven

Adicione a seguinte dependência ao seu pom.xml para incluir a biblioteca FOSS Aspose.Slides:

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-slides-foss</artifactId>
  <version>26.7.0</version>
</dependency>

Passo 2: Adicionar uma forma com um quadro de texto

Antes de formatar texto, uma forma deve conter um TextFrame.- Usar . shape.addTextFrame() para criar um.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IParagraph;
import org.aspose.slides.foss.IPortion;
import org.aspose.slides.foss.Portion;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    ISlideCollection slides = prs.getSlides();
    ISlide slide = slides.get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 500, 150
    );
    ITextFrame tf = shape.addTextFrame("Default text: will be formatted");
    prs.save("output.pptx", SaveFormat.PPTX);
}

Passo 3: Acesse o quadro de texto

shape.addTextFrame() Retorna o valor de: TextFrame Objeto. Você também pode recuperá-lo mais tarde através de shape.getTextFrame().

ITextFrame tf = shape.getTextFrame();          // if the frame already exists
ITextFrame tf = shape.addTextFrame("");        // creates a new frame

A. - Não . TextFrame contém uma lista de: Paragraph objetos (tf.getParagraphs()) Cada um. Paragraph contém: Portion objetos (paragraph.getPortions()).

Passo 4: Aplicar a formatação em negrito e itálico

Utilização: portionFormat.setFontBold() e a) portionFormat.setFontItalic().Estes métodos aceitam: NullableBool.TRUE, NullableBool.FALSE, ou NullableBool.NOT_DEFINED (herdado do mestre).

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IParagraph;
import org.aspose.slides.foss.IPortion;
import org.aspose.slides.foss.Portion;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    ISlideCollection slides = prs.getSlides();
    ISlide slide = slides.get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 500, 150
    );
    ITextFrame tf = shape.addTextFrame("Bold and italic text");

    IPortionFormat fmt = tf.getParagraphs().get(0)
        .getPortions().get(0).getPortionFormat();
    fmt.setFontBold(NullableBool.TRUE);
    fmt.setFontItalic(NullableBool.TRUE);

    prs.save("bold-italic.pptx", SaveFormat.PPTX);
}

Passo 5: Configure o tamanho e a cor da fonte

Set (s) portionFormat.setFontHeight() para tamanho (em pontos) e utilização getFillFormat() para a cor.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IParagraph;
import org.aspose.slides.foss.IPortion;
import org.aspose.slides.foss.Portion;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    ISlideCollection slides = prs.getSlides();
    ISlide slide = slides.get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 500, 150
    );
    ITextFrame tf = shape.addTextFrame("Large corporate-blue heading");

    IPortionFormat fmt = tf.getParagraphs().get(0)
        .getPortions().get(0).getPortionFormat();
    fmt.setFontHeight(32);                          // 32pt font
    fmt.setFontBold(NullableBool.TRUE);
    fmt.getFillFormat().setFillType(FillType.SOLID);
    fmt.getFillFormat().getSolidFillColor().setColor(
        Color.fromArgb(255, 0, 70, 127)
    );

    prs.save("colored-text.pptx", SaveFormat.PPTX);
}

Color.fromArgb(alpha, red, green, blue) Aceita valores 0-255 para cada canal.

Passo 6: Diversas partes num mesmo parágrafo

Um único parágrafo pode conter várias partes com formatamento diferente. Adicionar um novo Portion para um parágrafo de getPortions() Coleção:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IParagraph;
import org.aspose.slides.foss.IPortion;
import org.aspose.slides.foss.Portion;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    ISlideCollection slides = prs.getSlides();
    ISlide slide = slides.get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 600, 100
    );
    ITextFrame tf = shape.addTextFrame("");  // start with empty frame

    IParagraph paragraph = tf.getParagraphs().get(0);

    // First portion: normal text
    IPortion portion1 = paragraph.getPortions().get(0);
    portion1.setText("Normal text followed by ");
    portion1.getPortionFormat().setFontHeight(20);

    // Second portion: bold red text
    Portion portion2 = new Portion("bold red text");
    portion2.getPortionFormat().setFontHeight(20);
    portion2.getPortionFormat().setFontBold(NullableBool.TRUE);
    portion2.getPortionFormat().getFillFormat().setFillType(FillType.SOLID);
    portion2.getPortionFormat().getFillFormat().getSolidFillColor().setColor(
        Color.fromArgb(255, 200, 0, 0)
    );
    paragraph.getPortions().add(portion2);

    prs.save("mixed-format.pptx", SaveFormat.PPTX);
}

Problemas comuns e soluções

Texto aparece preto mesmo após a definição de cor

Assegurar a getFillFormat().setFillType(FillType.SOLID) Sem definir o tipo de preenchimento, a alteração da cor pode não ter efeito.

NullableBool.TRUE vs. true

portionFormat.setFontBold() espera que o NullableBool.TRUE, não Java’s true.Passar um booleano causará um erro de compilação, uma vez que o método espera a NullableBool - Não.

Fonte não aparece no arquivo guardado .

A Comissão setLatinFont() method define a família de fontes latinas. Se não for definida, é usada a fonte do tema da apresentação. As fontes personalizadas devem estar incorporadas ou disponíveis na máquina de visualização.

Perguntas Frequentes

Como posso mudar a família de fontes?

Set (s) portionFormat.setLatinFont() com um FontData instância que especifica o nome da fonte a aplicar àquela parte de texto:

fmt.setLatinFont(new FontData("Arial"));

FontData Aceita o nome da família de fontes como uma cadeia.

Como eu definir alinhamento parágrafo?

Utilização: paragraphFormat.setAlignment():

import org.aspose.slides.foss.TextAlignment;

tf.getParagraphs().get(0).getParagraphFormat()
    .setAlignment(TextAlignment.CENTER);

Valores suportados: LEFT, CENTER, RIGHT, JUSTIFY.

Como é que eu ajusto o espaço entre as linhas?

Utilização: paragraphFormat.setSpaceBefore() (ponto anterior ao parágrafo) ou paragraphFormat.setSpaceAfter() (ponto após o parágrafo):

tf.getParagraphs().get(0).getParagraphFormat().setSpaceBefore(12);  // 12pt before
tf.getParagraphs().get(0).getParagraphFormat().setSpaceAfter(6);    // 6pt after

Ver também:

 Português