在 PHP 中向簡報新增線條形狀

概觀

Aspose.Slides 讓您可以以程式方式在 PowerPoint 投影片中加入線條形狀。本文示範如何建立簡單的線條以及如何自訂線條，使其呈現為箭頭。

您將學會如何將線條形狀加入投影片、調整其外觀，並儲存更新後的簡報。範例著重於實用的線條格式設定，例如樣式、寬度、虛線模式、箭頭選項與填色。

建立純線條

若要在簡報的選取投影片中加入簡單的純線條，請依照以下步驟操作：

• 建立 Presentation 類別的實例。
• 使用索引取得投影片的參考。
• 使用 ShapeCollection 物件所提供的 addAutoShape 方法，新增 Line 類型的 AutoShape。
• 將修改後的簡報寫入為 PPTX 檔案。

以下範例中，我們已將線條加入簡報的第一張投影片。

  # 實例化代表 PPTX 檔案的 PresentationEx 類別
  $pres = new Presentation();
  try {
    # 取得第一張投影片
    $sld = $pres->getSlides()->get_Item(0);
    # 加入類型為 line 的 AutoShape
    $sld->getShapes()->addAutoShape(ShapeType::Line, 50, 150, 300, 0);
    # 將 PPTX 存寫至磁碟
    $pres->save("LineShape.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

建立箭頭形線條

Aspose.Slides for PHP via Java 亦允許開發人員設定線條的某些屬性，使其外觀更具吸引力。讓我們嘗試設定幾項線條屬性，使其呈現為箭頭。請依照以下步驟操作：

• 建立 Presentation 類別的實例。
• 使用索引取得投影片的參考。
• 使用 ShapeCollection 物件所提供的 addAutoShape 方法，新增 Line 類型的 AutoShape。
• 將 Line Style 設定為 Aspose.Slides for PHP via Java 所提供的其中一種樣式。
• 設定線條的寬度。
• 將線條的 Dash Style 設定為 Aspose.Slides for PHP via Java 所提供的其中一種樣式。
• 設定線條起點的 Arrow Head Style 與 Length。
• 設定線條終點的 Arrow Head Style 與 Length。
• 將修改後的簡報寫入為 PPTX 檔案。

  # 實例化代表 PPTX 檔案的 PresentationEx 類別
  $pres = new Presentation();
  try {
    # 取得第一張投影片
    $sld = $pres->getSlides()->get_Item(0);
    # 加入類型為 line 的 AutoShape
    $shp = $sld->getShapes()->addAutoShape(ShapeType::Line, 50, 150, 300, 0);
    # 對線條套用格式設定
    $shp->getLineFormat()->setStyle(LineStyle->ThickBetweenThin);
    $shp->getLineFormat()->setWidth(10);
    $shp->getLineFormat()->setDashStyle(LineDashStyle->DashDot);
    $shp->getLineFormat()->setBeginArrowheadLength(LineArrowheadLength->Short);
    $shp->getLineFormat()->setBeginArrowheadStyle(LineArrowheadStyle->Oval);
    $shp->getLineFormat()->setEndArrowheadLength(LineArrowheadLength->Long);
    $shp->getLineFormat()->setEndArrowheadStyle(LineArrowheadStyle->Triangle);
    $shp->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
    $shp->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(new java("java.awt.Color", PresetColor->Maroon));
    # 將 PPTX 儲存至磁碟
    $pres->save("LineShape.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

常見問題

我可以將一般線條轉換為連接線，使其自動貼齊形狀嗎？

不會。一般線條（AutoShape 中的 Line 類型）不會自動變成連接線。若要使其貼齊形狀，請使用專用的 Connector 類型，並透過 corresponding APIs 進行連接。

如果線條的屬性是從佈景主題繼承而來，且難以確定最終值，我該怎麼做？

讀取有效屬性 透過 LineFormatEffectiveData/LineFillFormatEffectiveData — 這些已經考慮了繼承與佈景樣式。

我可以鎖定線條，使其無法編輯（移動、調整大小）嗎？

可以。形狀提供 lock objects，讓您禁止編輯操作。