Cum să formataţi textul în Java

Aspose.Slides FOSS for Java provides fine-grained text formatting through the PortionFormat clasă. A 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ă aplici 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: Adaugă o formă cu un cadru de text

Înainte de a formata textul, o formă trebuie să conțină un TextFrame. Folosește 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: Accesează TextFrame-ul

shape.addTextFrame() returnează TextFrame obiectul. 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

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

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

Utilizați portionFormat.setFontBold() și portionFormat.setFontItalic(). Aceste metode acceptă NullableBool.TRUE, NullableBool.FALSE, sau NullableBool.NOT_DEFINED (moștenește 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 fontului și culoarea

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 singur paragraf

Un singur paragraf poate conține mai multe porțiuni cu formatare diferită. Adaugă un nou Portion la colecția unui paragraf getPortions() colecție:

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 soluții

Textul apare negru chiar și după setarea culorii

Asigură-te getFillFormat().setFillType(FillType.SOLID) este apelat înainte de a atribui culoarea. Fără setarea tipului de umplere, schimbarea culorii poate să nu aibă efect.

NullableBool.TRUE vs true

portionFormat.setFontBold() așteaptă NullableBool.TRUE, nu Java’s true. Transmiterea unui boolean va provoca o eroare de compilare deoarece metoda așteaptă NullableBool enum.

Fontul nu apare în fișierul salvat

Acesta setLatinFont() metoda 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?

Setează portionFormat.setLatinFont():

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

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

Cum pot seta alinierea paragrafului?

Folosește paragraphFormat.setAlignment():

import org.aspose.slides.foss.TextAlignment;

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

Valori acceptate: LEFT, CENTER, RIGHT, JUSTIFY.

Cum pot seta spațierea între linii?

Folosește 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