Quản lý các đoạn văn bản PowerPoint trong PHP

Giới thiệu

Aspose.Slides cung cấp tất cả các lớp bạn cần để làm việc với văn bản, đoạn và phần trong PowerPoint.

  • Aspose.Slides cung cấp lớp TextFrame cho phép bạn thêm các đối tượng đại diện cho một đoạn. Một đối tượng TextFame có thể chứa một hoặc nhiều đoạn (mỗi đoạn được tạo bằng dấu xuống dòng).
  • Aspose.Slides cung cấp lớp Paragraph cho phép bạn thêm các đối tượng đại diện cho các phần. Một đối tượng Paragraph có thể chứa một hoặc nhiều phần (tập hợp các đối tượng Portion).
  • Aspose.Slides cung cấp lớp Portion cho phép bạn thêm các đối tượng đại diện cho văn bản và các thuộc tính định dạng của chúng.

Một đối tượng Paragraph có khả năng xử lý văn bản với các thuộc tính định dạng khác nhau thông qua các đối tượng Portion bên dưới.

Thêm Nhiều Đoạn Chứa Nhiều Phần

Các bước sau cho bạn thấy cách thêm một khung văn bản chứa 3 đoạn và mỗi đoạn chứa 3 phần:

  1. Tạo một thể hiện của lớp Presentation.
  2. Truy cập tham chiếu của slide phù hợp thông qua chỉ số của nó.
  3. Thêm một AutoShape hình chữ nhật vào slide.
  4. Lấy ITextFrame liên kết với AutoShape.
  5. Tạo hai đối tượng Paragraph và thêm chúng vào bộ sưu tập đoạn của TextFrame.
  6. Tạo ba đối tượng Portion cho mỗi Paragraph mới (hai đối tượng Portion cho Paragraph mặc định) và thêm từng đối tượng Portion vào bộ sưu tập phần của mỗi Paragraph.
  7. Đặt một số văn bản cho mỗi phần.
  8. Áp dụng các tính năng định dạng mong muốn cho mỗi phần bằng cách sử dụng các thuộc tính định dạng được cung cấp bởi đối tượng Portion.
  9. Lưu bản trình chiếu đã chỉnh sửa.
# Tạo một lớp Presentation đại diện cho tệp PPTX
$pres = new Presentation();
try {
    # Truy cập slide đầu tiên
    $slide = $pres->getSlides()->get_Item(0);
    # Thêm một AutoShape loại Hình chữ nhật
    $ashp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 150, 300, 150);
    # Truy cập TextFrame của AutoShape
    $tf = $ashp->getTextFrame();
    # Tạo các Paragraph và Portion với các định dạng văn bản khác nhau
    $para0 = $tf->getParagraphs()->get_Item(0);
    $port01 = new Portion();
    $port02 = new Portion();
    $para0->getPortions()->add($port01);
    $para0->getPortions()->add($port02);
    $para1 = new Paragraph();
    $tf->getParagraphs()->add($para1);
    $port10 = new Portion();
    $port11 = new Portion();
    $port12 = new Portion();
    $para1->getPortions()->add($port10);
    $para1->getPortions()->add($port11);
    $para1->getPortions()->add($port12);
    $para2 = new Paragraph();
    $tf->getParagraphs()->add($para2);
    $port20 = new Portion();
    $port21 = new Portion();
    $port22 = new Portion();
    $para2->getPortions()->add($port20);
    $para2->getPortions()->add($port21);
    $para2->getPortions()->add($port22);
    for($i = 0; $i < 3; $i++) {
        for($j = 0; $j < 3; $j++) {
            $portion = $tf->getParagraphs()->get_Item($i)->getPortions()->get_Item($j);
            $portion->setText("Portion0" . $j);
            if ($j == 0) {
                $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
                $portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
                $portion->getPortionFormat()->setFontBold(NullableBool::True);
                $portion->getPortionFormat()->setFontHeight(15);
            } else if ($j == 1) {
                $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
                $portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);
                $portion->getPortionFormat()->setFontItalic(NullableBool::True);
                $portion->getPortionFormat()->setFontHeight(18);
            }
        }
    }
    # Ghi PPTX ra đĩa
    $pres->save("multiParaPort_out.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

Quản Lý Dấu Đầu Dòng Đoạn

Các danh sách dấu đầu dòng giúp bạn tổ chức và trình bày thông tin nhanh chóng và hiệu quả. Các đoạn có dấu đầu dòng luôn dễ đọc và hiểu hơn.

  1. Tạo một thể hiện của lớp Presentation.
  2. Truy cập tham chiếu của slide phù hợp thông qua chỉ số của nó.
  3. Thêm một AutoShape vào slide đã chọn.
  4. Truy cập TextFrame của AutoShape.
  5. Xóa đoạn mặc định trong TextFrame.
  6. Tạo thể hiện đoạn đầu tiên bằng lớp Paragraph.
  7. Đặt Type dấu đầu dòng cho đoạn thành Symbol và đặt ký tự dấu đầu dòng.
  8. Đặt Text cho đoạn.
  9. Đặt Indent cho dấu đầu dòng.
  10. Đặt màu cho dấu đầu dòng.
  11. Đặt chiều cao cho dấu đầu dòng.
  12. Thêm đoạn mới vào bộ sưu tập đoạn của TextFrame.
  13. Thêm đoạn thứ hai và lặp lại quy trình từ bước 7 đến 12.
  14. Lưu bản trình chiếu.
# Tạo một lớp Presentation đại diện cho tệp PPTX
$pres = new Presentation();
try {
    # Truy cập slide đầu tiên
    $slide = $pres->getSlides()->get_Item(0);
    # Thêm và truy cập Autoshape
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # Truy cập khung văn bản của autoshape
    $txtFrm = $aShp->getTextFrame();
    # Xóa đoạn mặc định
    $txtFrm->getParagraphs()->removeAt(0);
    # Tạo một đoạn
    $para = new Paragraph();
    # Đặt kiểu dấu đầu dòng và ký hiệu cho đoạn
    $para->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para->getParagraphFormat()->getBullet()->setChar(8226);
    # Đặt văn bản cho đoạn
    $para->setText("Welcome to Aspose.Slides");
    # Đặt thụt lề dấu đầu dòng
    $para->getParagraphFormat()->setIndent(25);
    # Đặt màu dấu đầu dòng
    $para->getParagraphFormat()->getBullet()->getColor()->setColorType(ColorType::RGB);
    $para->getParagraphFormat()->getBullet()->getColor()->setColor(java("java.awt.Color")->BLACK);
    $para->getParagraphFormat()->getBullet()->setBulletHardColor(NullableBool::True);// đặt IsBulletHardColor thành true để sử dụng màu dấu đầu dòng riêng

    # Đặt chiều cao dấu đầu dòng
    $para->getParagraphFormat()->getBullet()->setHeight(100);
    # Thêm đoạn vào khung văn bản
    $txtFrm->getParagraphs()->add($para);
    # Tạo đoạn thứ hai
    $para2 = new Paragraph();
    # Đặt loại và kiểu dấu đầu dòng cho đoạn
    $para2->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $para2->getParagraphFormat()->getBullet()->setNumberedBulletStyle(NumberedBulletStyle->BulletCircleNumWDBlackPlain);
    # Thêm văn bản cho đoạn
    $para2->setText("This is numbered bullet");
    # Đặt thụt lề dấu đầu dòng
    $para2->getParagraphFormat()->setIndent(25);
    # Đặt màu dấu đầu dòng
    $para2->getParagraphFormat()->getBullet()->getColor()->setColorType(ColorType::RGB);
    $para2->getParagraphFormat()->getBullet()->getColor()->setColor(java("java.awt.Color")->BLACK);
    $para2->getParagraphFormat()->getBullet()->setBulletHardColor(NullableBool::True);// đặt IsBulletHardColor thành true để sử dụng màu dấu đầu dòng riêng

    # Đặt chiều cao dấu đầu dòng
    $para2->getParagraphFormat()->getBullet()->setHeight(100);
    # Thêm đoạn vào khung văn bản
    $txtFrm->getParagraphs()->add($para2);
    # Lưu bản trình chiếu đã chỉnh sửa
    $pres->save("Bullet_out.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

Quản Lý Dấu Đầu Dòng Hình Ảnh

Các danh sách dấu đầu dòng giúp bạn tổ chức và trình bày thông tin nhanh chóng và hiệu quả. Các đoạn hình ảnh dễ đọc và hiểu.

  1. Tạo một thể hiện của lớp Presentation.
  2. Truy cập tham chiếu của slide phù hợp thông qua chỉ số của nó.
  3. Thêm một AutoShape vào slide.
  4. Truy cập TextFrame của AutoShape.
  5. Xóa đoạn mặc định trong TextFrame.
  6. Tạo thể hiện đoạn đầu tiên bằng lớp Paragraph.
  7. Tải hình ảnh trong PPImage.
  8. Đặt loại dấu đầu dòng thành Picture và đặt hình ảnh.
  9. Đặt Text cho Paragraph.
  10. Đặt Indent cho dấu đầu dòng.
  11. Đặt màu cho dấu đầu dòng.
  12. Đặt chiều cao cho dấu đầu dòng.
  13. Thêm đoạn mới vào bộ sưu tập đoạn của TextFrame.
  14. Thêm đoạn thứ hai và lặp lại quy trình dựa trên các bước trước.
  15. Lưu bản trình chiếu đã chỉnh sửa.
# Tạo một lớp Presentation đại diện cho tệp PPTX
$presentation = new Presentation();
try {
    # Truy cập slide đầu tiên
    $slide = $presentation->getSlides()->get_Item(0);
    # Tạo đối tượng ảnh cho dấu đầu dòng
    $picture;
    $image = Images->fromFile("bullets.png");
    try {
        $picture = $presentation->getImages()->addImage($image);
    } finally {
        if (!java_is_null($image)) {
            $image->dispose();
        }
    }
    # Thêm và truy cập Autoshape
    $autoShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # Truy cập khung văn bản của autoshape
    $textFrame = $autoShape->getTextFrame();
    # Xóa đoạn mặc định
    $textFrame->getParagraphs()->removeAt(0);
    # Tạo một đoạn mới
    $paragraph = new Paragraph();
    $paragraph->setText("Welcome to Aspose.Slides");
    # Đặt kiểu dấu đầu dòng và ảnh cho đoạn
    $paragraph->getParagraphFormat()->getBullet()->setType(BulletType::Picture);
    $paragraph->getParagraphFormat()->getBullet()->getPicture()->setImage($picture);
    # Đặt chiều cao dấu đầu dòng
    $paragraph->getParagraphFormat()->getBullet()->setHeight(100);
    # Thêm đoạn vào khung văn bản
    $textFrame->getParagraphs()->add($paragraph);
    # Ghi bản trình chiếu dưới dạng tệp PPTX
    $presentation->save("ParagraphPictureBulletsPPTX_out.pptx", SaveFormat::Pptx);
    # Ghi bản trình chiếu dưới dạng tệp PPT
    $presentation->save("ParagraphPictureBulletsPPT_out.ppt", SaveFormat::Ppt);
} catch (JavaException $e) {
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Quản Lý Dấu Đầu Dòng Đa Cấp

Các danh sách dấu đầu dòng giúp bạn tổ chức và trình bày thông tin nhanh chóng và hiệu quả. Dấu đầu dòng đa cấp dễ đọc và hiểu.

  1. Tạo một thể hiện của lớp Presentation.
  2. Truy cập tham chiếu của slide phù hợp thông qua chỉ số của nó.
  3. Thêm một AutoShape trong slide mới.
  4. Truy cập TextFrame của AutoShape.
  5. Xóa đoạn mặc định trong TextFrame.
  6. Tạo thể hiện đoạn đầu tiên qua lớp Paragraph và đặt độ sâu là 0.
  7. Tạo thể hiện đoạn thứ hai qua lớp Paragraph và đặt độ sâu là 1.
  8. Tạo thể hiện đoạn thứ ba qua lớp Paragraph và đặt độ sâu là 2.
  9. Tạo thể hiện đoạn thứ tư qua lớp Paragraph và đặt độ sâu là 3.
  10. Thêm các đoạn mới vào bộ sưu tập đoạn của TextFrame.
  11. Lưu bản trình chiếu đã chỉnh sửa.
# Tạo một lớp Presentation đại diện cho tệp PPTX
$pres = new Presentation();
try {
    # Truy cập slide đầu tiên
    $slide = $pres->getSlides()->get_Item(0);
    # Thêm và truy cập Autoshape
    $aShp = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # Truy cập khung văn bản của autoshape đã tạo
    $text = $aShp->addTextFrame("");
    # Xóa đoạn mặc định
    $text->getParagraphs()->clear();
    # Thêm đoạn đầu tiên
    $para1 = new Paragraph();
    $para1->setText("Content");
    $para1->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para1->getParagraphFormat()->getBullet()->setChar(8226);
    $para1->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para1->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Đặt mức độ dấu đầu dòng
    $para1->getParagraphFormat()->setDepth(0);
    # Thêm đoạn thứ hai
    $para2 = new Paragraph();
    $para2->setText("Second Level");
    $para2->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para2->getParagraphFormat()->getBullet()->setChar('-');
    $para2->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para2->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Đặt mức độ dấu đầu dòng
    $para2->getParagraphFormat()->setDepth(1);
    # Thêm đoạn thứ ba
    $para3 = new Paragraph();
    $para3->setText("Third Level");
    $para3->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para3->getParagraphFormat()->getBullet()->setChar(8226);
    $para3->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para3->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Đặt mức độ dấu đầu dòng
    $para3->getParagraphFormat()->setDepth(2);
    # Thêm đoạn thứ tư
    $para4 = new Paragraph();
    $para4->setText("Fourth Level");
    $para4->getParagraphFormat()->getBullet()->setType(BulletType::Symbol);
    $para4->getParagraphFormat()->getBullet()->setChar('-');
    $para4->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $para4->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Đặt mức độ dấu đầu dòng
    $para4->getParagraphFormat()->setDepth(3);
    # Thêm các đoạn vào bộ sưu tập
    $text->getParagraphs()->add($para1);
    $text->getParagraphs()->add($para2);
    $text->getParagraphs()->add($para3);
    $text->getParagraphs()->add($para4);
    # Ghi bản trình chiếu dưới dạng tệp PPTX
    $pres->save("MultilevelBullet.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

Quản Lý Đoạn Với Danh Sách Đánh Số Tùy Chỉnh

Lớp BulletFormat cung cấp phương thức setNumberedBulletStartWith và các phương thức khác cho phép bạn quản lý các đoạn với việc đánh số hoặc định dạng tùy chỉnh.

  1. Tạo một thể hiện của lớp Presentation.
  2. Truy cập slide chứa đoạn.
  3. Thêm một AutoShape vào slide.
  4. Truy cập TextFrame của AutoShape.
  5. Xóa đoạn mặc định trong TextFrame.
  6. Tạo thể hiện đoạn đầu tiên qua lớp Paragraph và đặt NumberedBulletStartWith thành 2.
  7. Tạo thể hiện đoạn thứ hai qua lớp Paragraph và đặt NumberedBulletStartWith thành 3.
  8. Tạo thể hiện đoạn thứ ba qua lớp Paragraph và đặt NumberedBulletStartWith thành 7.
  9. Thêm các đoạn mới vào bộ sưu tập đoạn của TextFrame.
  10. Lưu bản trình chiếu đã chỉnh sửa.
$presentation = new Presentation();
try {
    $shape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 400, 200);
    # Truy cập khung văn bản của autoshape đã tạo
    $textFrame = $shape->getTextFrame();
    # Xóa đoạn mặc định hiện có
    $textFrame->getParagraphs()->removeAt(0);
    # Danh sách đầu tiên
    $paragraph1 = new Paragraph();
    $paragraph1->setText("bullet 2");
    $paragraph1->getParagraphFormat()->setDepth(4);
    $paragraph1->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(2);
    $paragraph1->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $textFrame->getParagraphs()->add($paragraph1);
    $paragraph2 = new Paragraph();
    $paragraph2->setText("bullet 3");
    $paragraph2->getParagraphFormat()->setDepth(4);
    $paragraph2->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(3);
    $paragraph2->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $textFrame->getParagraphs()->add($paragraph2);
    $paragraph5 = new Paragraph();
    $paragraph5->setText("bullet 7");
    $paragraph5->getParagraphFormat()->setDepth(4);
    $paragraph5->getParagraphFormat()->getBullet()->setNumberedBulletStartWith(7);
    $paragraph5->getParagraphFormat()->getBullet()->setType(BulletType::Numbered);
    $textFrame->getParagraphs()->add($paragraph5);
    $presentation->save("SetCustomBulletsNumber-slides.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Đặt Thụt Lề Dòng Đầu Cho Đoạn

Sử dụng phương thức ParagraphFormat::setIndent để kiểm soát thụt lề dòng đầu của một đoạn. Phương thức này chỉ di chuyển dòng đầu so với lề trái của đoạn. Giá trị dương đẩy dòng đầu sang phải, trong khi các dòng còn lại vẫn căn theo thân đoạn.

Sử dụng ParagraphFormat::setMarginLeft khi cần di chuyển toàn bộ đoạn. Sử dụng ParagraphFormat::setIndent khi chỉ cần di chuyển dòng đầu.

Ví dụ bên dưới tạo một số đoạn và áp dụng các giá trị thụt lề khác nhau để minh họa cách thụt lề dòng đầu ảnh hưởng đến bố cục đoạn.

  1. Tạo một thể hiện của lớp Presentation.
  2. Truy cập slide mục tiêu.
  3. Thêm một AutoShape hình chữ nhật vào slide.
  4. Thêm một TextFrame rỗng vào hình và xóa đoạn mặc định.
  5. Tạo một số đoạn và đặt các giá trị Indent khác nhau cho chúng.
  6. Thêm các đoạn vào khung văn bản.
  7. Lưu bản trình chiếu đã chỉnh sửa.
$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $rectangleShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle,50,50,420,220);
    $rectangleShape->getFillFormat()->setFillType(FillType::NoFill);
    $rectangleShape->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $rectangleShape->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->GRAY);

    $textFrame = $rectangleShape->addTextFrame("");
    $textFrame->getTextFrameFormat()->setAutofitType(TextAutofitType::Shape);
    $textFrame->getParagraphs()->removeAt(0);

    $firstParagraph = new Paragraph();
    $firstParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $firstParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $firstParagraph->setText("No first-line indent. Wrapped lines start at the same position as the first line.");
    $firstParagraph->getParagraphFormat()->setMarginLeft(20.0);
    $firstParagraph->getParagraphFormat()->setIndent(0.0);

    $secondParagraph = new Paragraph();
    $secondParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $secondParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $secondParagraph->setText("First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body.");
    $secondParagraph->getParagraphFormat()->setMarginLeft(20.0);
    $secondParagraph->getParagraphFormat()->setIndent(20.0);

    $thirdParagraph = new Paragraph();
    $thirdParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $thirdParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $thirdParagraph->setText("First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see.");
    $thirdParagraph->getParagraphFormat()->setMarginLeft(20.0);
    $thirdParagraph->getParagraphFormat()->setIndent(40.0);

    $textFrame->getParagraphs()->add($firstParagraph);
    $textFrame->getParagraphs()->add($secondParagraph);
    $textFrame->getParagraphs()->add($thirdParagraph);

    $presentation->save("paragraph_indent.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Kết quả:

The first-line indent of the paragraphs

Đặt Thụt Lề Treo Cho Đoạn

Thụt lề treo là bố cục đoạn trong đó dòng đầu bắt đầu ở bên trái so với các dòng còn lại. Trong Aspose.Slides, bạn tạo hiệu ứng này bằng phương thức ParagraphFormat::setIndent. Đặt giá trị thụt lề âm để di chuyển dòng đầu sang trái so với thân đoạn.

Trong thực tế, ParagraphFormat::setMarginLeft xác định vị trí bên trái của thân đoạn, và ParagraphFormat::setIndent xác định vị trí của dòng đầu so với lề đó. Để tạo thụt lề treo, đặt giá trị MarginLeft dương và giá trị Indent âm.

Định dạng này hữu ích cho thư mục, tài liệu tham khảo, mục bảng chú giải và các đoạn khác nơi các dòng gập phải căn dưới thân đoạn thay vì dưới ký tự đầu tiên của dòng đầu.

  1. Tạo một thể hiện của lớp Presentation.
  2. Truy cập slide mục tiêu.
  3. Thêm một AutoShape hình chữ nhật vào slide.
  4. Thêm một TextFrame rỗng vào hình và xóa đoạn mặc định.
  5. Tạo các đoạn và đặt giá trị MarginLeft dương cho mỗi đoạn.
  6. Đặt giá trị Indent âm để tạo hiệu ứng thụt lề treo.
  7. Thêm các đoạn vào khung văn bản.
  8. Lưu bản trình chiếu đã chỉnh sửa.
$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $rectangleShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle,50,50,420,220);
    $rectangleShape->getFillFormat()->setFillType(FillType::NoFill);
    $rectangleShape->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $rectangleShape->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->GRAY);

    $textFrame = $rectangleShape->addTextFrame("");
    $textFrame->getTextFrameFormat()->setAutofitType(TextAutofitType::Shape);
    $textFrame->getParagraphs()->removeAt(0);

    $firstParagraph = new Paragraph();
    $firstParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $firstParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $firstParagraph->setText("A hanging indent is created by combining a positive left margin with a negative indent. The first line starts to the left, while wrapped lines align with the paragraph body.");
    $firstParagraph->getParagraphFormat()->setMarginLeft(40.0);
    $firstParagraph->getParagraphFormat()->setIndent(-20.0);

    $secondParagraph = new Paragraph();
    $secondParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $secondParagraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $secondParagraph->setText("This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare.");
    $secondParagraph->getParagraphFormat()->setMarginLeft(60.0);
    $secondParagraph->getParagraphFormat()->setIndent(-30.0);

    $textFrame->getParagraphs()->add($firstParagraph);
    $textFrame->getParagraphs()->add($secondParagraph);

    $presentation->save("hanging_indent.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

Kết quả:

The hanging indent of the paragraphs

Quản Lý Thuộc Tính Kết Thúc Đoạn

  1. Tạo một thể hiện của lớp Presentation.
  2. Lấy tham chiếu tới slide chứa đoạn thông qua vị trí của nó.
  3. Thêm một AutoShape hình chữ nhật vào slide.
  4. Thêm một TextFrame với hai đoạn vào hình chữ nhật.
  5. Đặt độ cao phông chữ và kiểu Font cho các đoạn.
  6. Đặt các thuộc tính End cho các đoạn.
  7. Ghi bản trình chiếu đã chỉnh sửa dưới dạng tệp PPTX.
$pres = new Presentation();
try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 10, 200, 250);
    $para1 = new Paragraph();
    $para1->getPortions()->add(new Portion("Sample text"));
    $para2 = new Paragraph();
    $para2->getPortions()->add(new Portion("Sample text 2"));
    $portionFormat = new PortionFormat();
    $portionFormat::setFontHeight(48);
    $portionFormat::setLatinFont(new FontData("Times New Roman"));
    $para2->setEndParagraphPortionFormat($portionFormat);
    $shape->getTextFrame()->getParagraphs()->add($para1);
    $shape->getTextFrame()->getParagraphs()->add($para2);
    $pres->save($resourcesOutputPath . "pres.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

Nhập Văn Bản HTML Vào Đoạn

Aspose.Slides cung cấp hỗ trợ nâng cao cho việc nhập văn bản HTML vào các đoạn.

  1. Tạo một thể hiện của lớp Presentation.
  2. Truy cập tham chiếu của slide phù hợp thông qua chỉ số của nó.
  3. Thêm một AutoShape vào slide.
  4. Thêm và truy cập TextFrame của AutoShape.
  5. Xóa đoạn mặc định trong TextFrame.
  6. Đọc tệp HTML nguồn bằng một TextReader.
  7. Tạo thể hiện đoạn đầu tiên qua lớp Paragraph.
  8. Thêm nội dung tệp HTML đã đọc từ TextReader vào ParagraphCollection của TextFrame.
  9. Lưu bản trình chiếu đã chỉnh sửa.
# Tạo một thể hiện Presentation rỗng
$pres = new Presentation();
try {
    # Truy cập slide đầu tiên mặc định của bản trình chiếu
    $slide = $pres->getSlides()->get_Item(0);
    # Thêm AutoShape để chứa nội dung HTML
    $ashape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 10, $pres->getSlideSize()->getSize()->getWidth() - 20, $pres->getSlideSize()->getSize()->getHeight() - 10);
    $ashape->getFillFormat()->setFillType(FillType::NoFill);
    # Thêm khung văn bản vào hình
    $ashape->addTextFrame("");
    # Xóa tất cả các đoạn trong khung văn bản đã thêm
    $ashape->getTextFrame()->getParagraphs()->clear();
    # Tải tệp HTML bằng stream reader
    $tr = new StreamReader("file.html");
    # Thêm văn bản từ stream reader HTML vào khung văn bản
    $ashape->getTextFrame()->getParagraphs()->addFromHtml($tr->readToEnd());
    # Lưu bản trình chiếu
    $pres->save("output_out.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

Xuất Văn Bản Đoạn Sang HTML

Aspose.Slides cung cấp hỗ trợ nâng cao cho việc xuất văn bản (được chứa trong các đoạn) sang HTML.

  1. Tạo một thể hiện của lớp Presentation và tải bản trình chiếu mong muốn.
  2. Truy cập tham chiếu của slide phù hợp thông qua chỉ số của nó.
  3. Truy cập hình chứa văn bản sẽ được xuất sang HTML.
  4. Truy cập TextFrame của hình.
  5. Tạo một thể hiện của StreamWriter và thêm tệp HTML mới.
  6. Cung cấp chỉ mục bắt đầu cho StreamWriter và xuất các đoạn mong muốn.
# Tải tệp bản trình chiếu
$pres = new Presentation("ExportingHTMLText.pptx");
try {
    # Truy cập slide đầu tiên mặc định của bản trình chiếu
    $slide = $pres->getSlides()->get_Item(0);
    # Chỉ mục mong muốn
    $index = 0;
    # Truy cập hình đã thêm
    $ashape = $slide->getShapes()->get_Item($index);
    # Tạo tệp HTML đầu ra
    $os = new Java("java.io.FileOutputStream", "output.html");
    $writer = new OutputStreamWriter($os, "UTF-8");
    # Trích xuất đoạn đầu tiên dưới dạng HTML
    # Ghi dữ liệu các đoạn vào HTML bằng cách cung cấp chỉ mục bắt đầu của đoạn và tổng số đoạn cần sao chép
    $writer->write($ashape->getTextFrame()->getParagraphs()->exportToHtml(0, $ashape->getTextFrame()->getParagraphs()->getCount(), null));
    $writer->close();
} catch (JavaException $e) {
} finally {
    if (!java_is_null($pres)) {
        $pres->dispose();
    }
}

Lưu Đoạn Thành Ảnh

Trong phần này, chúng ta sẽ khám phá hai ví dụ minh họa cách lưu một đoạn văn bản, được đại diện bởi lớp Paragraph, dưới dạng ảnh. Cả hai ví dụ đều bao gồm việc lấy ảnh của hình chứa đoạn bằng các phương thức getImage từ lớp Shape, tính toán giới hạn của đoạn trong hình, và xuất nó dưới dạng ảnh bitmap. Các cách tiếp cận này cho phép bạn trích xuất các phần cụ thể của văn bản từ bản trình chiếu PowerPoint và lưu chúng thành ảnh riêng, hữu ích cho các tình huống sử dụng khác nhau.

Giả sử chúng ta có một tệp bản trình chiếu tên là sample.pptx với một slide, trong đó hình đầu tiên là một hộp văn bản chứa ba đoạn.

The text box with three paragraphs

Ví dụ 1

Trong ví dụ này, chúng ta lấy đoạn thứ hai dưới dạng ảnh. Để làm điều này, chúng ta trích xuất ảnh của hình từ slide đầu tiên của bản trình chiếu, sau đó tính toán giới hạn của đoạn thứ hai trong khung văn bản của hình. Đoạn sau đó được vẽ lại lên một ảnh bitmap mới và lưu dưới dạng PNG. Phương pháp này đặc biệt hữu ích khi bạn cần lưu một đoạn cụ thể dưới dạng ảnh riêng trong khi giữ nguyên kích thước và định dạng của văn bản.

$imageIO = new Java("javax.imageio.ImageIO");

$presentation = new Presentation("sample.pptx");
try {
    $firstShape = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0);

    // Lưu hình dạng trong bộ nhớ dưới dạng bitmap.
    $shapeImage = $firstShape->getImage();
    $shapeImageStream = new Java("java.io.ByteArrayOutputStream");
    $shapeImage->save($shapeImageStream, ImageFormat::Png);
    $shapeImage->dispose();

    // Tạo bitmap cho hình dạng từ bộ nhớ.
    $shapeImageInputStream = new Java("java.io.ByteArrayInputStream", $shapeImageStream->toByteArray());
    $shapeBitmap = $imageIO->read($shapeImageInputStream);

    // Tính toán giới hạn của đoạn thứ hai.
    $secondParagraph = $firstShape->getTextFrame()->getParagraphs()->get_Item(1);
    $paragraphRectangle = $secondParagraph->getRect();

    // Tính toán tọa độ và kích thước cho ảnh đầu ra (kích thước tối thiểu - 1x1 pixel).
    $imageX = floor(java_values($paragraphRectangle->getX()));
    $imageY = floor(java_values($paragraphRectangle->getY()));
    $imageWidth = max(1, ceil(java_values($paragraphRectangle->getWidth())));
    $imageHeight = max(1, ceil(java_values($paragraphRectangle->getHeight())));

    // Cắt bitmap của hình dạng để chỉ lấy bitmap của đoạn.
    $paragraphBitmap = $shapeBitmap->getSubimage($imageX, $imageY, $imageWidth, $imageHeight);

    $imageIO->write($paragraphBitmap, "png", new Java("java.io.File", "paragraph.png"));
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Kết quả:

The paragraph image

Ví dụ 2

Trong ví dụ này, chúng ta mở rộng cách tiếp cận trước bằng cách thêm các hệ số tỷ lệ cho ảnh đoạn. Hình được trích xuất từ bản trình chiếu và lưu dưới dạng ảnh với hệ số tỷ lệ là 2. Điều này cho phép xuất ảnh có độ phân giải cao hơn khi xuất đoạn. Các giới hạn của đoạn sau đó được tính toán xét tới tỷ lệ. Việc tỷ lệ hoá có thể đặc biệt hữu ích khi cần ảnh chi tiết hơn, ví dụ để sử dụng trong tài liệu in chất lượng cao.

$imageIO = new Java("javax.imageio.ImageIO");

$imageScaleX = 2;
$imageScaleY = $imageScaleX;

$presentation = new Presentation("sample.pptx");
try {
    $firstShape = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0);

    // Lưu hình dạng trong bộ nhớ dưới dạng bitmap có tỷ lệ.
    $shapeImage = $firstShape->getImage(ShapeThumbnailBounds::Shape, $imageScaleX, $imageScaleY);
    $shapeImageStream = new Java("java.io.ByteArrayOutputStream");
    $shapeImage->save($shapeImageStream, ImageFormat::Png);
    $shapeImage->dispose();

    // Tạo bitmap cho hình dạng từ bộ nhớ.
    $shapeImageInputStream = new Java("java.io.ByteArrayInputStream", $shapeImageStream->toByteArray());
    $shapeBitmap = $imageIO->read($shapeImageInputStream);

    // Tính toán giới hạn của đoạn thứ hai.
    $secondParagraph = $firstShape->getTextFrame()->getParagraphs()->get_Item(1);
    $paragraphRectangle = $secondParagraph->getRect();
    $paragraphRectangle->setRect(
            java_values($paragraphRectangle->getX()) * $imageScaleX,
            java_values($paragraphRectangle->getY()) * $imageScaleY,
            java_values($paragraphRectangle->getWidth()) * $imageScaleX,
            java_values($paragraphRectangle->getHeight()) * $imageScaleY
    );

    // Tính toán tọa độ và kích thước cho ảnh đầu ra (kích thước tối thiểu - 1x1 pixel).
    $imageX = floor(java_values($paragraphRectangle->getX()));
    $imageY = floor(java_values($paragraphRectangle->getY()));
    $imageWidth = max(1, ceil(java_values($paragraphRectangle->getWidth())));
    $imageHeight = max(1, ceil(java_values($paragraphRectangle->getHeight())));

    // Cắt bitmap của hình dạng để chỉ lấy bitmap của đoạn.
    $paragraphBitmap = $shapeBitmap->getSubimage($imageX, $imageY, $imageWidth, $imageHeight);

    $imageIO->write($paragraphBitmap, "png", new Java("java.io.File", "paragraph.png"));
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Câu Hỏi Thường Gặp

Tôi có thể tắt hoàn toàn việc ngắt dòng trong khung văn bản không?

Có. Sử dụng cài đặt ngắt dòng của khung văn bản (setWrapText) để tắt ngắt dòng, vì vậy các dòng sẽ không bị cắt ở các cạnh của khung.

Làm thế nào để tôi lấy chính xác giới hạn trên slide của một đoạn cụ thể?

Bạn có thể lấy hình chữ nhật bao quanh của đoạn (hoặc thậm chí của một phần) để biết vị trí và kích thước chính xác của nó trên slide.

Ở đâu được kiểm soát việc căn chỉnh đoạn (trái/phải/giữa/đều)?

Alignment là một cài đặt mức độ đoạn trong ParagraphFormat; nó áp dụng cho toàn bộ đoạn bất kể định dạng của các phần riêng lẻ.

Tôi có thể đặt ngôn ngữ kiểm tra chính tả cho chỉ một phần của đoạn (ví dụ, một từ) không?

Có. Ngôn ngữ được đặt ở mức độ phần (PortionFormat::setLanguageId), vì vậy có thể có nhiều ngôn ngữ cùng tồn tại trong một đoạn.

Nâng cao bài thuyết trình của bạn với AutoFit trong PHP Lấy giới hạn đoạn văn từ bài thuyết trình trong PHP