使用 PHP 管理 PowerPoint 表格中的列與欄

簡介

為了讓您能在 PowerPoint 簡報中管理表格的列與欄，Aspose.Slides 提供了 Table 類別以及其他多種型別。

將首行設定為標題列

  1. 建立 Presentation 類別的實例並載入簡報。
  2. 透過索引取得投影片的參照。
  3. 建立一個 Table 物件，並將其設為 null。
  4. 遍歷所有 Shape 物件以尋找相關的表格。
  5. 將表格的首列設定為標題列。

以下 PHP 程式碼示範如何將表格的首列設定為標題列：

  # 實例化 Presentation 類別
  $pres = new Presentation("table.pptx");
  try {
    # 取得第一張投影片
    $sld = $pres->getSlides()->get_Item(0);
    # 初始化 null TableEx
    $tbl = null;
    # 迭代形狀並設定表格的參照
    foreach($sld->getShapes() as $shp) {
      if (java_instanceof($shp, new JavaClass("com.aspose.slides.Table"))) {
        $tbl = $shp;
        # 將表格的第一列設定為標題列
        $tbl->setFirstRow(true);
      }
    }
    # 將簡報儲存至磁碟
    $pres->save("pres.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

複製表格列或欄

  1. 建立 Presentation 類別的實例並載入簡報,
  2. 透過索引取得投影片的參照。
  3. 定義 columnWidth 陣列。
  4. 定義 rowHeight 陣列。
  5. 透過 addTable 方法將 Table 物件新增至投影片。
  6. 複製表格列。
  7. 複製表格欄。
  8. 儲存已修改的簡報。

以下 PHP 程式碼示範如何複製 PowerPoint 表格的列或欄：

  # 實例化 Presentation 類別
  $pres = new Presentation("Test.pptx");
  try {
    # 取得第一張投影片
    $sld = $pres->getSlides()->get_Item(0);
    # 定義欄寬與列高
    $dblCols = array(50, 50, 50 );
    $dblRows = array(50, 30, 30, 30, 30 );
    # 在投影片上新增表格形狀
    $table = $sld->getShapes()->addTable(100, 50, $dblCols, $dblRows);
    # 在第 1 列第 1 格加入文字
    $table->get_Item(0, 0)->getTextFrame()->setText("Row 1 Cell 1");
    # 在第 1 列第 2 格加入文字
    $table->get_Item(1, 0)->getTextFrame()->setText("Row 1 Cell 2");
    # 在表格末端複製第 1 列
    $table->getRows()->addClone($table->getRows()->get_Item(0), false);
    # 在第 2 列第 1 格加入文字
    $table->get_Item(0, 1)->getTextFrame()->setText("Row 2 Cell 1");
    # 在第 2 列第 2 格加入文字
    $table->get_Item(1, 1)->getTextFrame()->setText("Row 2 Cell 2");
    # 複製第 2 列為表格的第 4 列
    $table->getRows()->insertClone(3, $table->getRows()->get_Item(1), false);
    # 在末端複製第一欄
    $table->getColumns()->addClone($table->getColumns()->get_Item(0), false);
    # 在第 4 個欄位索引處複製第 2 欄
    $table->getColumns()->insertClone(3, $table->getColumns()->get_Item(1), false);
    # 將簡報儲存至磁碟
    $pres->save("table_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

從表格中移除列或欄

  1. 建立 Presentation 類別的實例並載入簡報,
  2. 透過索引取得投影片的參照。
  3. 定義 columnWidth 陣列。
  4. 定義 rowHeight 陣列。
  5. 透過 addTable 方法將 Table 物件新增至投影片。
  6. 移除表格列。
  7. 移除表格欄。
  8. 儲存已修改的簡報。

以下 PHP 程式碼示範如何從表格中移除列或欄：

  $pres = new Presentation();
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $colWidth = array(100, 50, 30 );
    $rowHeight = array(30, 50, 30 );
    $table = $slide->getShapes()->addTable(100, 100, $colWidth, $rowHeight);
    $table->getRows()->removeAt(1, false);
    $table->getColumns()->removeAt(1, false);
    $pres->save("TestTable_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

在表格列層級設定文字格式

  1. 建立 Presentation 類別的實例並載入簡報,
  2. 透過索引取得投影片的參照。
  3. 從投影片中取得相關的 Table 物件。
  4. 設定首列儲存格的 setFontHeight(float value)。
  5. 設定首列儲存格的 setAlignment(int value) 與 setMarginRight(float value)。
  6. 設定次列儲存格的 setTextVerticalType(byte value)。
  7. 儲存已修改的簡報。

以下 PHP 程式碼示範此操作。

  # 建立 Presentation 類別的實例
  $pres = new Presentation();
  try {
    # 假設第一張投影片的第一個形狀是表格
    $someTable = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    # 設定首列儲存格的字型高度
    $portionFormat = new PortionFormat();
    $portionFormat::setFontHeight(25);
    $someTable->getRows()->get_Item(0)->setTextFormat($portionFormat);
    # 設定首列儲存格的文字對齊方式與右邊距
    $paragraphFormat = new ParagraphFormat();
    $paragraphFormat::setAlignment(TextAlignment->Right);
    $paragraphFormat::setMarginRight(20);
    $someTable->getRows()->get_Item(0)->setTextFormat($paragraphFormat);
    # 設定第二列儲存格的文字垂直類型
    $textFrameFormat = new TextFrameFormat();
    $textFrameFormat::setTextVerticalType(TextVerticalType::Vertical);
    $someTable->getRows()->get_Item(1)->setTextFormat($textFrameFormat);
    # 將簡報儲存至磁碟
    $pres->save("result.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

在表格欄層級設定文字格式

  1. 建立 Presentation 類別的實例並載入簡報,
  2. 透過索引取得投影片的參照。
  3. 從投影片中取得相關的 Table 物件。
  4. 設定首欄儲存格的 setFontHeight(float value)。
  5. 設定首欄儲存格的 setAlignment(int value) 與 setMarginRight(float value)。
  6. 設定次欄儲存格的 setTextVerticalType(byte value)。
  7. 儲存已修改的簡報。

以下 PHP 程式碼示範此操作：

  # 建立 Presentation 類別的實例
  $pres = new Presentation();
  try {
    # 假設第一張投影片的第一個形狀是表格
    $someTable = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    # 設定第一欄儲存格的字型高度
    $portionFormat = new PortionFormat();
    $portionFormat::setFontHeight(25);
    $someTable->getColumns()->get_Item(0)->setTextFormat($portionFormat);
    # 一次設定第一欄儲存格的文字對齊方式與右邊距
    $paragraphFormat = new ParagraphFormat();
    $paragraphFormat::setAlignment(TextAlignment->Right);
    $paragraphFormat::setMarginRight(20);
    $someTable->getColumns()->get_Item(0)->setTextFormat($paragraphFormat);
    # 設定第二欄儲存格的文字垂直類型
    $textFrameFormat = new TextFrameFormat();
    $textFrameFormat::setTextVerticalType(TextVerticalType::Vertical);
    $someTable->getColumns()->get_Item(1)->setTextFormat($textFrameFormat);
    $pres->save("result.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

取得表格樣式屬性

Aspose.Slides 允許您取得表格的樣式屬性，以便將這些細節用於其他表格或其他地方。以下 PHP 程式碼示範如何從表格預設樣式取得樣式屬性：

  $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);// 更改預設樣式預設主題

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

常見問題

我可以將 PowerPoint 主題/樣式套用到已建立的表格嗎？

可以。表格會繼承投影片/版面配置/母片的主題，且您仍可在此基礎上覆寫填色、邊框與文字顏色。

我可以像 Excel 那樣排序表格列嗎？

不行，Aspose.Slides 的表格沒有內建排序或篩選功能。請先在記憶體中排序資料，然後依排序後的順序重新填入表格列。

我可以在保持特定儲存格自訂顏色的同時使用帶狀（條紋）欄嗎？

可以。開啟欄帶狀樣式，然後以局部格式覆寫特定儲存格；儲存格級別的格式會優先於表格樣式。

在 PHP 中管理簡報表格 使用 PHP 管理簡報中的表格儲存格