Szöveg formázása Java-ban

Aspose.Slides FOSS for Java finomhangolt szövegformázást biztosít a PortionFormat osztályon keresztül. A Portion a legkisebb önálló szövegegység; egy bekezdésen belüli egyetlen formázási futathoz (run) térképezhető. Ez az útmutató bemutatja, hogyan alkalmazhatók félkövér, dőlt, betűméret és színformázások egy prezentáció szövegére.

Lépésről‑lépésre útmutató

1. lépés: Adja hozzá a Maven függőséget

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

2. lépés: Alakzat hozzáadása szövegkerettel

A szöveg formázása előtt egy alakzatnak tartalmaznia kell egy TextFrame. Használja a shape.addTextFrame()-t egy létrehozásához.

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

3. lépés: A TextFrame elérése

shape.addTextFrame() visszaadja a TextFrame objektumot. Később is lekérdezhető a shape.getTextFrame() segítségével.

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

A TextFrame egy listát tartalmaz Paragraph objektumokból (tf.getParagraphs()).
Minden Paragraph Portion objektumot tartalmaz (paragraph.getPortions()).

4. lépés: Félkövér és dőlt formázás alkalmazása

Használja a portionFormat.setFontBold() és portionFormat.setFontItalic() elemeket. Ezek a módszerek elfogadják a NullableBool.TRUE, NullableBool.FALSE vagy NullableBool.NOT_DEFINED (öröklődik a masterből).

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

5. lépés: Betűméret és szín beállítása

Állítsa be portionFormat.setFontHeight() a mérethez (pontban), és használja getFillFormat()‑t a színhez.

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) minden csatornára 0-255 közötti értékeket fogad el.

6. lépés: Több rész egy bekezdésben

Egy bekezdés több, különböző formázású részt is tartalmazhat. Adj hozzá egy új Portion elemet a bekezdés getPortions() gyűjteményéhez:

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

Általános problémák és megoldások

A szöveg fekete marad a szín beállítása után

Győződjön meg róla, hogy a getFillFormat().setFillType(FillType.SOLID) hívásra kerül a szín hozzárendelése előtt. A kitöltés típusának beállítása nélkül a színváltozás hatástalan lehet.

NullableBool.TRUE vs true

portionFormat.setFontBold() NullableBool.TRUE-t vár, nem a Java true-t. Boolean érték átadása fordítási hibát okoz, mivel a metódus a NullableBool enumot várja.

A betűtípus nem jelenik meg a mentett fájlban

A setLatinFont() metódus beállítja a latin betűcsaládot. Ha nincs beállítva, a prezentáció témájának betűtípusa kerül felhasználásra. Az egyéni betűtípusokat be kell ágyazni, vagy elérhetőnek kell lenniük a megtekintő gépen.

Gyakran Ismételt Kérdések

Hogyan változtathatom meg a betűcsaládot?

Halmaz portionFormat.setLatinFont():

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

FontData elfogadja a betűcsalád nevét karakterláncként.

Hogyan állíthatom be a bekezdés igazítását?

Használja a paragraphFormat.setAlignment()-t:

import org.aspose.slides.foss.TextAlignment;

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

Támogatott értékek: LEFT, CENTER, RIGHT, JUSTIFY.

Hogyan állíthatom be a sortávolságot?

Használja a paragraphFormat.setSpaceBefore() (pontok a bekezdés előtt) vagy a paragraphFormat.setSpaceAfter() (pontok a bekezdés után) jelöléseket:

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