Cum să formatați text în Java

Aspose.Slides FOSS pentru Java oferă formatare de text detaliată prin clasa PortionFormat. Un Portion este cea mai mică unitate independentă de text; se mapă la o singură rulă de formatare într-un paragraf. Acest ghid arată cum să aplicați formatarea îngroșată, cursivă, dimensiunea fontului și culoarea textului într-o prezentare.

Ghid pas cu pas

Pasul 1: Adăugați dependența Maven

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

Pasul 2: Adăugați o formă cu un cadru de text

Înainte de a formata textul, o formă trebuie să conțină un TextFrame. Folosiți shape.addTextFrame() pentru a crea una.

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);
}

Pasul 3: Accesarea TextFrame

shape.addTextFrame() returnează obiectul TextFrame. De asemenea, îl poţi recupera mai târziu prin shape.getTextFrame().

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

A TextFrame conține o listă de obiecte Paragraph (tf.getParagraphs()). Fiecare Paragraph conține obiecte Portion (paragraph.getPortions()).

Pasul 4: Aplică formatarea îngroșată și cursivă

Utilizați portionFormat.setFontBold() și portionFormat.setFontItalic(). Aceste metode acceptă NullableBool.TRUE, NullableBool.FALSE sau NullableBool.NOT_DEFINED (moștenesc de la 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);
}

Pasul 5: Setează dimensiunea și culoarea fontului

Setați portionFormat.setFontHeight() pentru dimensiune (în puncte) și utilizați getFillFormat() pentru culoare.

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) acceptă valori 0-255 pentru fiecare canal.

Pasul 6: Mai multe porțiuni într-un paragraf

Un paragraf unic poate conține mai multe porțiuni cu formatare diferită. Adăugați un nou Portion la colecția getPortions() a unui paragraf:

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);
}

Probleme comune și remedii

Textul apare negru chiar și după setarea culorii

Asigurați-vă că getFillFormat().setFillType(FillType.SOLID) este apelat înainte de a atribui culoarea. Fără setarea tipului de umplere, modificarea culorii poate să nu aibă efect.

NullableBool.TRUE vs true

portionFormat.setFontBold() așteaptă NullableBool.TRUE, nu true din Java. Transmiterea unui boolean va genera o eroare de compilare deoarece metoda așteaptă enumul NullableBool.

Fontul nu apare în fișierul salvat

Metoda setLatinFont() setează familia de fonturi latină. Dacă nu este setată, se folosește fontul temei de prezentare. Fonturile personalizate trebuie să fie încorporate sau disponibile pe mașina de vizualizare.

Întrebări frecvente

Cum pot schimba familia de fonturi?

Seta portionFormat.setLatinFont():

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

FontData acceptă numele familiei de fonturi ca un șir.

Cum să setez alinierea paragrafului?

Utilizați paragraphFormat.setAlignment():

import org.aspose.slides.foss.TextAlignment;

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

Valori acceptate: LEFT, CENTER, RIGHT, JUSTIFY.

Cum să setez spațierea dintre linii?

Folosiți paragraphFormat.setSpaceBefore() (puncte înainte de paragraf) sau paragraphFormat.setSpaceAfter() (puncte după paragraf):

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