Kuinka muotoilla teksti Java:ssa

Aspose.Slides FOSS for Java provides fine-grained text formatting through the PortionFormat luokka. A Portion on pienin itsenäinen tekstiyksikkö; se vastaa yhtä muotoilukierrosta kappaleessa. Tämä opas näyttää, miten lihavointi, kursivointi, fonttikoko ja väri voidaan soveltaa tekstiin esityksessä.

Vaiheittainen opas

Vaihe 1: Lisää Maven‑riippuvuus

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

Vaihe 2: Lisää muoto, jossa on tekstikehys

Ennen tekstin muotoilua, muodon on sisällettävä TextFrame. Käytä shape.addTextFrame() luodaksesi sellaisen.

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

Vaihe 3: Pääse TextFrameen

shape.addTextFrame() palauttaa TextFrame objektin. Voit myös hakea sen myöhemmin kautta shape.getTextFrame().

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

A TextFrame sisältää luettelon Paragraph objekteja (tf.getParagraphs()). Jokainen Paragraph sisältää Portion objekteja (paragraph.getPortions()).

Vaihe 4: Sovella lihavointia ja kursivointia

Käytä portionFormat.setFontBold() ja portionFormat.setFontItalic(). Nämä menetelmät hyväksyvät NullableBool.TRUE, NullableBool.FALSE, tai NullableBool.NOT_DEFINED (periytyy masterista).

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

Vaihe 5: Aseta fonttikoko ja väri

Aseta portionFormat.setFontHeight() koko (pisteinä) varten ja käytä getFillFormat() värille.

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) hyväksyy arvot 0‑255 jokaiselle kanavalle.

Vaihe 6: Useita osioita yhdessä kappaleessa

Yksi kappale voi sisältää useita osia, joilla on eri muotoilu. Lisää uusi Portion kappaleen getPortions() kokoelmaan:

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

Yleisiä ongelmia ja korjauksia

Teksti näkyy mustana, vaikka väri on asetettu

Varmista getFillFormat().setFillType(FillType.SOLID) kutsutaan ennen värin asettamista. Ilman täyttötyypin asettamista värin muutos ei välttämättä vaikuta.

NullableBool.TRUE vs true

portionFormat.setFontBold() odottaa NullableBool.TRUE, ei Java’n true. Booleanin välittäminen aiheuttaa käännösvirheen, koska metodi odottaa NullableBool enumeraatiota.

Fontti ei näy tallennetussa tiedostossa

Metodi setLatinFont() metodi asettaa latinalaisen fonttiperheen. Jos sitä ei aseteta, käytetään esityksen teeman fonttia. Mukautetut fontit on upotettava tai niiden on oltava saatavilla katselukoneessa.

Usein kysytyt kysymykset

Kuinka vaihdan fonttiperheen?

Aseta portionFormat.setLatinFont():

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

FontData hyväksyy fonttiperheen nimen merkkijonona.

Kuinka asetetaan kappaleen tasaus?

Käytä paragraphFormat.setAlignment():

import org.aspose.slides.foss.TextAlignment;

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

Tuetut arvot: LEFT, CENTER, RIGHT, JUSTIFY.

Kuinka asetetaan riviväli?

Käytä paragraphFormat.setSpaceBefore() (pisteet ennen kappaletta) tai paragraphFormat.setSpaceAfter() (pisteet kappaleen jälkeen):

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