วิธีจัดรูปแบบข้อความใน Java

Aspose.Slides FOSS for Java ให้การจัดรูปแบบข้อความแบบละเอียดผ่านคลาส PortionFormat. Portion คือหน่วยข้อความอิสระที่เล็กที่สุด; มันแมปไปยังการรันการจัดรูปแบบเดียวภายในย่อหน้า. คู่มือนี้แสดงวิธีการใช้การจัดรูปแบบตัวหนา, ตัวเอียง, ขนาดฟอนต์, และสีกับข้อความในงานนำเสนอ.

คู่มือแบบขั้นตอนต่อขั้นตอน

ขั้นตอนที่ 1: เพิ่มการพึ่งพา Maven

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

ขั้นตอนที่ 2: เพิ่มรูปทรงพร้อมกรอบข้อความ

ก่อนทำการจัดรูปแบบข้อความ รูปร่างต้องมี TextFrame. ใช้ shape.addTextFrame() เพื่อสร้างหนึ่ง.

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: เข้าถึง TextFrame

shape.addTextFrame() คืนค่าอ็อบเจ็กต์ TextFrame. คุณยังสามารถดึงคืนได้ในภายหลังผ่าน shape.getTextFrame().

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

TextFrame มีรายการของวัตถุ Paragraph (tf.getParagraphs()). แต่ละ Paragraph ประกอบด้วยวัตถุ Portion (paragraph.getPortions()).

ขั้นตอนที่ 4: ใช้การจัดรูปแบบตัวหนาและตัวเอียง

ใช้ portionFormat.setFontBold() และ portionFormat.setFontItalic(). วิธีเหล่านี้รับ NullableBool.TRUE, NullableBool.FALSE หรือ NullableBool.NOT_DEFINED (สืบทอดจาก 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);
}

ขั้นตอนที่ 5: ตั้งค่าขนาดและสีของฟอนต์

ตั้งค่า portionFormat.setFontHeight() สำหรับขนาด (เป็นจุด) และใช้ getFillFormat() สำหรับสี.

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) ยอมรับค่าตั้งแต่ 0‑255 สำหรับแต่ละช่องสัญญาณ.

ขั้นตอนที่ 6: หลายส่วนในย่อหน้าเดียว

ย่อหน้าเดียวสามารถมีหลายส่วนที่มีการจัดรูปแบบต่างกัน เพิ่ม Portion ใหม่ลงในคอลเลกชัน getPortions() ของย่อหน้า:

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

ปัญหาทั่วไปและการแก้ไข

ข้อความปรากฏเป็นสีดำแม้จะตั้งสีแล้ว

ตรวจสอบให้แน่ใจว่า getFillFormat().setFillType(FillType.SOLID) ถูกเรียกก่อนการกำหนดสี หากไม่ได้ตั้งค่าชนิดการเติม สีอาจไม่มีผล

NullableBool.TRUE เทียบกับ true

portionFormat.setFontBold() คาดหวัง NullableBool.TRUE ไม่ใช่ true ของ Java. การส่งค่า boolean จะทำให้เกิดข้อผิดพลาดในการคอมไพล์เนื่องจากเมธอดคาดหวัง enum NullableBool.

แบบอักษรไม่ปรากฏในไฟล์ที่บันทึก

วิธี setLatinFont() ตั้งค่าครอบครัวฟอนต์ Latin หากไม่ได้ตั้งค่า จะใช้ฟอนต์ของธีมการนำเสนอ ฟอนต์ที่กำหนดเองต้องฝังไว้หรือมีอยู่ในเครื่องที่ดู.

คำถามที่พบบ่อย

ฉันจะเปลี่ยนตระกูลฟอนต์อย่างไร?

ตั้งค่า portionFormat.setLatinFont():

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

FontData รับชื่อฟอนต์ตระกูลเป็นสตริง.

ฉันจะตั้งค่าการจัดแนวย่อหน้าอย่างไร?

ใช้ paragraphFormat.setAlignment():

import org.aspose.slides.foss.TextAlignment;

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

ค่าที่รองรับ: LEFT, CENTER, RIGHT, JUSTIFY.

ฉันจะตั้งระยะห่างบรรทัดอย่างไร?

ใช้ paragraphFormat.setSpaceBefore() (จุดก่อนย่อหน้า) หรือ paragraphFormat.setSpaceAfter() (จุดหลังย่อหน้า):

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