Kuinka muotoilla tekstiä Javassa

Aspose.Slides FOSS for Java tarjoaa hienojakoista tekstin muotoilua PortionFormat-luokan kautta. Portion on pienin itsenäinen tekstiyksikkö; se vastaa yhtä muotoilujaksoa 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 sellainen.

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ääsy TextFrameen

shape.addTextFrame() palauttaa TextFrame-objektin. Voit myös hakea sen myöhemmin shape.getTextFrame()-menetelmällä.

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

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

Vaihe 4: Käytä 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 (periytyvät 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() koon (pisteinä) varten ja käytä getFillFormat() väriin.

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 osia yhdessä kappaleessa

Yksi kappale voi sisältää useita osia, joilla on eri muotoiluja. 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);
}

Yleiset ongelmat ja korjaukset

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

Varmista, että getFillFormat().setFillType(FillType.SOLID) kutsutaan ennen värin asettamista. Jos täyttötyyppiä ei aseteta, värin muutos ei välttämättä vaikuta.

NullableBool.TRUE vs true

portionFormat.setFontBold() odottaa NullableBool.TRUE, ei Javan true. Booleanin välittäminen aiheuttaa käännösvirheen, koska metodi odottaa NullableBool-enumia.

Fontti ei näy tallennetussa tiedostossa

setLatinFont()-menetelmä asettaa latinalaisen fonttiperheen. Jos sitä ei ole asetettu, käytetään esityksen teeman fonttia. Mukautetut fontit on upotettava tai niiden on oltava saatavilla katselukoneessa.

Usein kysytyt kysymykset

Miten 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.

Miten 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