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

> 學習如何使用 Aspose.Slides for PHP via Java 操作 PowerPoint 簡報中的線條格式設定。探索屬性、方法與範例。

Source: https://docs.aspose.com/slides/zh-hant/php-java/line/


## **概觀**

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

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

## **建立純線條**

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

- 建立 [Presentation](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/Presentation) 類別的實例。
- 使用索引取得投影片的參考。
- 使用 [ShapeCollection](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/shapecollection/) 物件所提供的 [addAutoShape](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/shapecollection/#addAutoShape) 方法，新增 Line 類型的 AutoShape。
- 將修改後的簡報寫入為 PPTX 檔案。

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

```php
  # 實例化代表 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](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/Presentation) 類別的實例。
- 使用索引取得投影片的參考。
- 使用 [ShapeCollection](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/shapecollection/) 物件所提供的 [addAutoShape](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/shapecollection/#addAutoShape) 方法，新增 Line 類型的 AutoShape。
- 將 [Line Style](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/LineStyle) 設定為 Aspose.Slides for PHP via Java 所提供的其中一種樣式。
- 設定線條的寬度。
- 將線條的 [Dash Style](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/LineDashStyle) 設定為 Aspose.Slides for PHP via Java 所提供的其中一種樣式。
- 設定線條起點的 [Arrow Head Style](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/LineArrowheadStyle) 與 [Length](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/LineArrowheadLength)。
- 設定線條終點的 [Arrow Head Style](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/LineArrowheadStyle) 與 [Length](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/LineArrowheadLength)。
- 將修改後的簡報寫入為 PPTX 檔案。

```php
  # 實例化代表 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](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/autoshape/) 中的 [Line](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/shapetype/) 類型）不會自動變成連接線。若要使其貼齊形狀，請使用專用的 [Connector](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/connector/) 類型，並透過 [corresponding APIs](/slides/zh-hant/php-java/connector/) 進行連接。

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

[讀取有效屬性](/slides/zh-hant/php-java/shape-effective-properties/) 透過 `LineFormatEffectiveData`/`LineFillFormatEffectiveData` — 這些已經考慮了繼承與佈景樣式。

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

可以。形狀提供 [lock objects](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/autoshape/getautoshapelock/)，讓您禁止編輯操作。