Aspose.Slides FOSS
Java
How to Format Text in Java

How to Format Text in Java

Aspose.Slides FOSS for Java provides fine-grained text formatting through the PortionFormat klasa. A Portion jest najmniejszą niezależną jednostką tekstu; odpowiada pojedynczemu fragmentowi formatowania w akapicie. Ten przewodnik pokazuje, jak zastosować pogrubienie, kursywę, rozmiar czcionki i formatowanie koloru do tekstu w prezentacji.

Przewodnik krok po kroku

Krok 1: Dodaj zależność Maven 

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

Krok 2: Dodaj kształt z ramką tekstową

Przed formatowaniem tekstu, kształt musi zawierać TextFrame. Użyj shape.addTextFrame() aby utworzyć jeden.

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()) {
    ISlide slide = prs.getSlides().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);
}

Krok 3: Uzyskaj dostęp do TextFrame

shape.addTextFrame() zwraca TextFrame obiekt. Możesz także pobrać go później za pomocą shape.getTextFrame().

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

A TextFrame zawiera listę Paragraph obiektów (tf.getParagraphs()). Każdy Paragraph zawiera Portion obiekty (paragraph.getPortions()).

Krok 4: Zastosuj formatowanie pogrubienia i kursywy

Użyj portionFormat.setFontBold() i portionFormat.setFontItalic(). Te metody akceptują NullableBool.TRUE, NullableBool.FALSE, lub NullableBool.NOT_DEFINED (dziedziczy po master).

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()) {
    ISlide slide = prs.getSlides().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);
}

Krok 5: Ustaw rozmiar czcionki i kolor

Ustaw portionFormat.setFontHeight() dla rozmiaru (w punktach) i użyj getFillFormat() dla koloru.

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()) {
    ISlide slide = prs.getSlides().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) akceptuje wartości 0-255 dla każdego kanału.

Krok 6: Wiele fragmentów w jednym akapicie

Pojedynczy akapit może zawierać wiele fragmentów o różnym formatowaniu. Dodaj nowy Portion do akapitu getPortions() kolekcji:

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()) {
    ISlide slide = prs.getSlides().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);
}

Typowe problemy i rozwiązania

Tekst pozostaje czarny mimo ustawienia koloru

Upewnij się getFillFormat().setFillType(FillType.SOLID) jest wywoływane przed przypisaniem koloru. Bez ustawienia typu wypełnienia zmiana koloru może nie mieć efektu.

NullableBool.TRUE vs true

portionFormat.setFontBold() oczekuje NullableBool.TRUE, nie Java’s true. Przekazanie wartości boolowskiej spowoduje błąd kompilacji, ponieważ metoda oczekuje NullableBool enumeracji.

Czcionka nie pojawia się w zapisanym pliku

Ten setLatinFont() metoda ustawia rodzinę czcionek łacińskich. Jeśli nie zostanie ustawiona, używana jest czcionka motywu prezentacji. Czcionki niestandardowe muszą być osadzone lub dostępne na maszynie wyświetlającej.

Najczęściej zadawane pytania

Jak zmienić rodzinę czcionek?

Ustaw portionFormat.setLatinFont():

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

FontData przyjmuje nazwę rodziny czcionek jako ciąg znaków.

Jak ustawić wyrównanie akapitu?

Użyj paragraphFormat.setAlignment():

import org.aspose.slides.foss.TextAlignment;

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

Obsługiwane wartości: LEFT, CENTER, RIGHT, JUSTIFY.

Jak ustawić odstęp między wierszami?

Użyj paragraphFormat.setSpaceBefore() (punkty przed akapitem) lub paragraphFormat.setSpaceAfter() (punkty po akapicie):

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

Zobacz także

 Polski