Quản lý bảng trình chiếu trong PHP

Giới thiệu

Bảng trong PowerPoint là một cách hiệu quả để hiển thị và mô tả thông tin. Thông tin trong lưới các ô (sắp xếp thành hàng và cột) rất rõ ràng và dễ hiểu.

Aspose.Slides cung cấp lớp Table, lớp Cell và các kiểu khác để cho phép bạn tạo, cập nhật và quản lý bảng trong mọi loại bản trình bày.

Tạo bảng từ đầu

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu tới một slide thông qua chỉ mục của nó.
Định nghĩa một mảng columnWidth.
Định nghĩa một mảng rowHeight.
Thêm một đối tượng Table vào slide bằng phương thức addTable.
Duyệt qua từng Cell để áp dụng định dạng cho các đường viền trên, dưới, phải và trái.
Gộp hai ô đầu tiên của hàng đầu tiên trong bảng.
Truy cập TextFrame của một Cell.
Thêm một số văn bản vào TextFrame.
Lưu bản trình bày đã sửa đổi.

Mã PHP sau cho bạn thấy cách tạo bảng trong một bản trình bày:

  # Khởi 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
    $sld = $pres->getSlides()->get_Item(0);
    # Xác định các cột với độ rộng và các hàng với chiều cao
    $dblCols = array(50, 50, 50 );
    $dblRows = array(50, 30, 30, 30, 30 );
    # Thêm một đối tượng bảng vào slide
    $tbl = $sld->getShapes()->addTable(100, 50, $dblCols, $dblRows);
    # Đặt định dạng viền cho mỗi ô
    for($row = 0; $row < java_values($tbl->getRows()->size()) ; $row++) {
      for($cell = 0; $cell < java_values($tbl->getRows()->get_Item($row)->size()) ; $cell++) {
        $cellFormat = $tbl->getRows()->get_Item($row)->get_Item($cell)->getCellFormat();
        $cellFormat::getBorderTop()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderTop()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderTop()->setWidth(5);
        $cellFormat::getBorderBottom()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderBottom()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderBottom()->setWidth(5);
        $cellFormat::getBorderLeft()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderLeft()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderLeft()->setWidth(5);
        $cellFormat::getBorderRight()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderRight()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderRight()->setWidth(5);
      }
    }
    # Hợp nhất ô 1 và 2 của hàng 1
    $tbl->mergeCells($tbl->getRows()->get_Item(0)->get_Item(0), $tbl->getRows()->get_Item(1)->get_Item(1), false);
    # Thêm một số văn bản vào ô đã hợp nhất
    $tbl->getRows()->get_Item(0)->get_Item(0)->getTextFrame()->setText("Merged Cells");
    # Lưu bản trình chiếu vào ổ đĩa
    $pres->save("table.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Đánh số trong bảng tiêu chuẩn

Trong một bảng tiêu chuẩn, việc đánh số các ô là đơn giản và bắt đầu từ 0. Ô đầu tiên trong bảng có chỉ mục là 0,0 (cột 0, hàng 0).

Ví dụ, các ô trong một bảng có 4 cột và 4 hàng được đánh số như sau:

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

Mã PHP sau cho bạn thấy cách chỉ định đánh số cho các ô trong bảng:

  # Khởi 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
    $sld = $pres->getSlides()->get_Item(0);
    # Xác định các cột với độ rộng và các hàng với chiều cao
    $dblCols = array(70, 70, 70, 70 );
    $dblRows = array(70, 70, 70, 70 );
    # Thêm một đối tượng bảng vào slide
    $tbl = $sld->getShapes()->addTable(100, 50, $dblCols, $dblRows);
    # Đặt định dạng viền cho mỗi ô
    foreach($tbl->getRows() as $row) {
      foreach($row as $cell) {
        $cell->getCellFormat()->getBorderTop()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderTop()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderTop()->setWidth(5);
        $cell->getCellFormat()->getBorderBottom()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderBottom()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderBottom()->setWidth(5);
        $cell->getCellFormat()->getBorderLeft()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderLeft()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderLeft()->setWidth(5);
        $cell->getCellFormat()->getBorderRight()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderRight()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderRight()->setWidth(5);
      }
    }
    # Lưu bản trình chiếu vào đĩa
    $pres->save("StandardTables_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Truy cập bảng hiện có

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu tới slide chứa bảng thông qua chỉ mục của nó.
Tạo một đối tượng Table và đặt nó thành null.
Duyệt qua tất cả các đối tượng Shape cho tới khi tìm thấy bảng.

Nếu bạn nghi ngờ slide đang làm việc chỉ chứa một bảng, bạn có thể kiểm tra tất cả các shape trong slide. Khi một shape được xác định là bảng, bạn có thể chuyển đổi kiểu thành đối tượng Table. Nhưng nếu slide chứa nhiều bảng, bạn nên tìm bảng cần thiết thông qua thuộc tính setAlternativeText(String value).
Sử dụng đối tượng Table để làm việc với bảng. Trong ví dụ dưới, chúng tôi đã thêm một hàng mới vào bảng.
Lưu bản trình bày đã sửa đổi.

Mã PHP sau cho bạn thấy cách truy cập và làm việc với một bảng hiện có:

  # Khởi tạo lớp Presentation đại diện cho tệp PPTX
  $pres = new Presentation("UpdateExistingTable.pptx");
  try {
    # Truy cập slide đầu tiên
    $sld = $pres->getSlides()->get_Item(0);
    # Khởi tạo TableEx null
    $tbl = null;
    # Duyệt qua các shape và thiết lập tham chiếu tới bảng được tìm thấy
    foreach($sld->getShapes() as $shp) {
      if (java_instanceof($shp, new JavaClass("com.aspose.slides.Table"))) {
        $tbl = $shp;
        # Đặt văn bản cho cột đầu tiên của hàng thứ hai
        $tbl->get_Item(0, 1)->getTextFrame()->setText("New");
      }
    }
    # Lưu bản trình chiếu đã chỉnh sửa vào đĩa
    $pres->save("table1_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Căn chỉnh văn bản trong bảng

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu tới một slide thông qua chỉ mục của nó.
Thêm một đối tượng Table vào slide.
Truy cập một đối tượng TextFrame từ bảng.
Truy cập Paragraph.
Căn chỉnh văn bản theo chiều dọc.
Lưu bản trình bày đã sửa đổi.

Mã PHP sau cho bạn thấy cách căn chỉnh văn bản trong bảng:

  # Tạo một thể hiện của lớp Presentation
  $pres = new Presentation();
  try {
    # Lấy slide đầu tiên
    $slide = $pres->getSlides()->get_Item(0);
    # Xác định các cột với độ rộng và các hàng với chiều cao
    $dblCols = array(120, 120, 120, 120 );
    $dblRows = array(100, 100, 100, 100 );
    # Thêm shape bảng vào slide
    $tbl = $slide->getShapes()->addTable(100, 50, $dblCols, $dblRows);
    $tbl->get_Item(1, 0)->getTextFrame()->setText("10");
    $tbl->get_Item(2, 0)->getTextFrame()->setText("20");
    $tbl->get_Item(3, 0)->getTextFrame()->setText("30");
    # Truy cập khung văn bản
    $txtFrame = $tbl->get_Item(0, 0)->getTextFrame();
    # Tạo đối tượng Paragraph cho khung văn bản
    $paragraph = $txtFrame->getParagraphs()->get_Item(0);
    # Tạo đối tượng Portion cho đoạn văn
    $portion = $paragraph->getPortions()->get_Item(0);
    $portion->setText("Text here");
    $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Căn chỉnh văn bản theo chiều dọc
    $cell = $tbl->get_Item(0, 0);
    $cell->setTextAnchorType(TextAnchorType::Center);
    $cell->setTextVerticalType(TextVerticalType::Vertical270);
    # Lưu bản trình chiếu vào đĩa
    $pres->save("Vertical_Align_Text_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Thiết lập định dạng văn bản ở mức bảng

Tạo một thể hiện của lớp Presentation.
Lấy tham chiếu tới một slide thông qua chỉ mục của nó.
Truy cập một đối tượng Table từ Slide.
Đặt setFontHeight(float value) cho văn bản.
Đặt setAlignment(int value) và setMarginRight(float value).
Đặt setTextVerticalType(byte value).
Lưu bản trình bày đã sửa đổi.

Mã PHP sau cho bạn thấy cách áp dụng các tùy chọn định dạng ưa thích cho văn bản trong bảng:

  # Tạo một thể hiện của lớp Presentation
  $pres = new Presentation("simpletable.pptx");
  try {
    # Giả sử shape đầu tiên trên slide đầu tiên là một bảng
    $someTable = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    # Đặt chiều cao phông chữ cho các ô của bảng
    $portionFormat = new PortionFormat();
    $portionFormat::setFontHeight(25);
    $someTable->setTextFormat($portionFormat);
    # Đặt căn chỉnh văn bản và lề phải cho các ô của bảng trong một lần gọi
    $paragraphFormat = new ParagraphFormat();
    $paragraphFormat::setAlignment(TextAlignment->Right);
    $paragraphFormat::setMarginRight(20);
    $someTable->setTextFormat($paragraphFormat);
    # Đặt kiểu dọc cho văn bản của các ô bảng
    $textFrameFormat = new TextFrameFormat();
    $textFrameFormat::setTextVerticalType(TextVerticalType::Vertical);
    $someTable->setTextFormat($textFrameFormat);
    $pres->save("result.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Lấy các thuộc tính kiểu bảng

Aspose.Slides cho phép bạn truy xuất các thuộc tính kiểu của một bảng để có thể sử dụng chi tiết này cho bảng khác hoặc nơi khác. Mã PHP sau cho bạn thấy cách lấy các thuộc tính kiểu từ một kiểu bảng được đặt trước:

  $pres = new Presentation();
  try {
    $table = $pres->getSlides()->get_Item(0)->getShapes()->addTable(10, 10, array(100, 150 ), array(5, 5, 5 ));
    $table->setStylePreset(TableStylePreset->DarkStyle1);// thay đổi chủ đề preset style mặc định

    $pres->save("table.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Khóa tỷ lệ khung hình của bảng

Tỷ lệ khung hình của một hình dạng hình học là tỉ lệ kích thước của nó ở các chiều khác nhau. Aspose.Slides cung cấp phương thức setAspectRatioLocked để cho phép bạn khóa cài đặt tỷ lệ khung hình cho các bảng và các hình dạng khác.

Mã PHP sau cho bạn thấy cách khóa tỷ lệ khung hình cho một bảng:

  $pres = new Presentation("pres.pptx");
  try {
    $table = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    echo("Lock aspect ratio set: " . $table->getGraphicalObjectLock()->getAspectRatioLocked());
    $table->getGraphicalObjectLock()->setAspectRatioLocked(!$table->getGraphicalObjectLock()->getAspectRatioLocked());// invert

    echo("Lock aspect ratio set: " . $table->getGraphicalObjectLock()->getAspectRatioLocked());
    $pres->save("pres-out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

Tôi có thể bật chế độ đọc từ phải sang trái (RTL) cho toàn bộ bảng và văn bản trong các ô không?

Có. Bảng cung cấp phương thức setRightToLeft, và các đoạn văn có ParagraphFormat::setRightToLeft. Sử dụng cả hai sẽ đảm bảo thứ tự và hiển thị RTL đúng bên trong các ô.

Làm thế nào để ngăn người dùng di chuyển hoặc thay đổi kích thước bảng trong tệp cuối cùng?

Sử dụng các khóa shape để vô hiệu hoá việc di chuyển, thay đổi kích thước, lựa chọn, v.v. Các khóa này cũng áp dụng cho bảng.

Có hỗ trợ chèn hình ảnh làm nền trong ô không?

Có. Bạn có thể thiết lập một picture fill cho ô; hình ảnh sẽ phủ toàn bộ khu vực ô theo chế độ đã chọn (kéo dài hoặc lát gạch).

Quản lý các hàng và cột trong bảng PowerPoint bằng PHP