Aspose.Slides FOSS
Java
Cách định dạng văn bản trong Java

Cách định dạng văn bản trong Java

Aspose.Slides FOSS for Java provides fine-grained text formatting through the PortionFormat lớp. A Portion là đơn vị độc lập nhỏ nhất của văn bản; nó tương ứng với một chuỗi định dạng duy nhất trong một đoạn văn. Hướng dẫn này cho thấy cách áp dụng định dạng in đậm, in nghiêng, kích thước phông chữ và màu sắc cho văn bản trong một bản trình chiếu.

Hướng Dẫn Từng Bước

Bước 1: Thêm phụ thuộc Maven 

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

Bước 2: Thêm một Hình dạng với Khung Văn bản

Trước khi định dạng văn bản, một hình dạng phải chứa một TextFrame. Sử dụng shape.addTextFrame() để tạo một.

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

Bước 3: Truy cập TextFrame

shape.addTextFrame() trả về TextFrame đối tượng. Bạn cũng có thể lấy lại nó sau này qua shape.getTextFrame().

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

A TextFrame chứa một danh sách các Paragraph đối tượng (tf.getParagraphs()). Mỗi Paragraph chứa Portion đối tượng (paragraph.getPortions()).

Bước 4: Áp dụng định dạng In đậm và In nghiêng

Sử dụng portionFormat.setFontBold() và portionFormat.setFontItalic(). Các phương thức này chấp nhận NullableBool.TRUE, NullableBool.FALSE, hoặc NullableBool.NOT_DEFINED (kế thừa từ 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);
}

Bước 5: Đặt Kích thước Phông chữ và Màu sắc

Đặt portionFormat.setFontHeight() cho kích thước (theo điểm) và sử dụng getFillFormat() cho màu.

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) chấp nhận các giá trị 0-255 cho mỗi kênh.

Bước 6: Nhiều Portion trong một Đoạn văn

Một đoạn văn duy nhất có thể chứa nhiều phần với định dạng khác nhau. Thêm một Portion vào một đoạn văn của getPortions() bộ sưu tập:

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

Các Vấn Đề Thường Gặp và Cách Khắc Phục

Văn bản vẫn hiển thị màu đen ngay cả sau khi đã đặt màu

Đảm bảo getFillFormat().setFillType(FillType.SOLID) được gọi trước khi gán màu. Nếu không đặt loại tô, việc thay đổi màu có thể không có hiệu lực.

NullableBool.TRUE vs true

portionFormat.setFontBold() mong đợi NullableBool.TRUE, không phải Java’s true. Việc truyền một giá trị boolean sẽ gây lỗi biên dịch vì phương thức yêu cầu NullableBool enum.

Phông chữ không xuất hiện trong tệp đã lưu

Phương thức setLatinFont() đặt họ phông chữ Latin. Nếu không được đặt, phông chữ của giao diện trình chiếu sẽ được sử dụng. Phông chữ tùy chỉnh phải được nhúng hoặc có sẵn trên máy xem.

Câu hỏi thường gặp

Làm thế nào để thay đổi họ phông chữ?

Đặt portionFormat.setLatinFont():

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

FontData chấp nhận tên họ phông chữ dưới dạng chuỗi.

Làm thế nào để thiết lập căn chỉnh đoạn văn?

Sử dụng paragraphFormat.setAlignment():

import org.aspose.slides.foss.TextAlignment;

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

Các giá trị được hỗ trợ: LEFT, CENTER, RIGHT, JUSTIFY.

Làm thế nào để thiết lập khoảng cách dòng?

Sử dụng paragraphFormat.setSpaceBefore() (điểm trước đoạn) hoặc paragraphFormat.setSpaceAfter() (điểm sau đoạn văn):

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

Xem thêm

 Tiếng Việt