# 使用 PHP 強化簡報的 AutoFit 功能

> 在 Aspose.Slides for PHP 中管理 AutoFit 設定，以優化 PowerPoint 與 OpenDocument 簡報中的文字顯示，提升內容可讀性。

Source: https://docs.aspose.com/slides/zh-hant/php-java/manage-autofit-settings/


## **簡介**

預設情況下，當您新增文字方塊時，Microsoft PowerPoint 會使用 **Resize shape to fix text** 設定—它會自動調整文字方塊的大小，以確保文字始終能完整容納於其中。

![textbox-in-powerpoint](textbox-in-powerpoint.png)

* 當文字方塊中的文字變長或變大時，PowerPoint 會自動放大文字方塊（增加高度），以容納更多文字。  
* 當文字方塊中的文字變短或變小時，PowerPoint 會自動縮小文字方塊（減少高度），以清除多餘的空間。  

在 PowerPoint 中，有 4 個重要的參數或選項會控制文字方塊的自動調整行為：

* **Do not Autofit**
* **Shrink text on overflow**
* **Resize shape to fit text**
* **Wrap text in shape.**

![autofit-options-powerpoint](autofit-options-powerpoint.png)

Aspose.Slides for PHP via Java 提供類似的選項——[TextFrameFormat](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/TextFrameFormat) 類中某些屬性——讓您能在簡報中控制文字方塊的自動調整行為。

## **調整形狀大小以匹配文字**

如果您希望文字在方塊內始終能完整呈現，則必須使用 **Resize shape to fix text** 選項。要設定此屬性，將 [AutofitType](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/TextFrameFormat#getAutofitType--)（屬於 [TextFrameFormat](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/TextFrameFormat) 類）設定為 `Shape`。

![alwaysfit-setting-powerpoint](alwaysfit-setting-powerpoint.png)

此 PHP 程式碼示範如何在 PowerPoint 簡報中指定文字必須永遠適合其方塊：

```php
  $pres = new Presentation();
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $autoShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 30, 30, 350, 100);
    $portion = new Portion("lorem ipsum...");
    $portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $autoShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->add($portion);
    $textFrameFormat = $autoShape->getTextFrame()->getTextFrameFormat();
    $textFrameFormat::setAutofitType(TextAutofitType::Shape);
    $pres->save("Output-presentation.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }
```

如果文字變長或變大，文字方塊會自動調整大小（高度增加），以確保所有文字都能容納；若文字變短，則會相反。

## **不要自動調整大小**

如果您希望文字方塊或圖形在文字變更後保持原有尺寸，必須使用 **Do not Autofit** 選項。要設定此屬性，將 [AutofitType](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/TextFrameFormat#getAutofitType--)（屬於 [TextFrameFormat](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/TextFrameFormat) 類）設定為 `None`。

![donotautofit-setting-powerpoint](donotautofit-setting-powerpoint.png)

此 PHP 程式碼示範如何在 PowerPoint 簡報中指定文字方塊必須保留其尺寸：

```php
  $pres = new Presentation();
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $autoShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 30, 30, 350, 100);
    $portion = new Portion("lorem ipsum...");
    $portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $autoShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->add($portion);
    $textFrameFormat = $autoShape->getTextFrame()->getTextFrameFormat();
    $textFrameFormat::setAutofitType(TextAutofitType::None);
    $pres->save("Output-presentation.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }
```

當文字過長而無法容納於方塊時，文字會溢出。

## **文字溢出時縮小**

如果文字過長而無法容納於方塊，您可以透過 **Shrink text on overflow** 選項，指定系統自動縮小文字的大小與間距以符合方塊。要設定此屬性，將 [AutofitType](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/TextFrameFormat#getAutofitType--)（屬於 [TextFrameFormat](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/TextFrameFormat) 類）設定為 `Normal`。

![shrinktextonoverflow-setting-powerpoint](shrinktextonoverflow-setting-powerpoint.png)

此 PHP 程式碼示範如何在 PowerPoint 簡報中指定文字在溢出時縮小：

```php
  $pres = new Presentation();
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $autoShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 30, 30, 350, 100);
    $portion = new Portion("lorem ipsum...");
    $portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $autoShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->add($portion);
    $textFrameFormat = $autoShape->getTextFrame()->getTextFrameFormat();
    $textFrameFormat::setAutofitType(TextAutofitType::Normal);
    $pres->save("Output-presentation.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }
```

{{% alert title="Info" color="info" %}}
使用 **Shrink text on overflow** 選項時，只有當文字過長而無法容納於方塊時，設定才會生效。
{{% /alert %}}

## **在形狀內換行**

如果您希望文字在超出形狀寬度時自動換行，必須使用 **Wrap text in shape** 參數。要設定此屬性，請將 [WrapText](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/TextFrameFormat#getWrapText--)（屬於 [TextFrameFormat](https://reference.aspose.com/slides/zh-hant/php-java/aspose.slides/TextFrameFormat) 類）設定為 `true`。

此 PHP 程式碼示範如何在 PowerPoint 簡報中使用換行設定：

```php
  $pres = new Presentation();
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $autoShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 30, 30, 350, 100);
    $portion = new Portion("lorem ipsum...");
    $portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $autoShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->add($portion);
    $textFrameFormat = $autoShape->getTextFrame()->getTextFrameFormat();
    $textFrameFormat::setWrapText(NullableBool::True);
    $pres->save("Output-presentation.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }
```

{{% alert title="Note" color="warning" %}} 
如果將 `WrapText` 屬性設為 `False`，當形狀內的文字長度超過形狀寬度時，文字會沿單行延伸超出形狀邊界。
{{% /alert %}}

## **常見問答**

**文字框的內部邊距會影響 AutoFit 嗎？**  
是的。內部邊距（Padding）會減少可用的文字區域，導致 AutoFit 會較早觸發—會更早縮小字型或調整圖形尺寸。請先檢查並調整邊距，再調整 AutoFit 設定。

**AutoFit 與手動換行或軟換行之間的互動情形為何？**  
強制換行會保留原位，AutoFit 會在其周圍調整字型大小與間距。移除不必要的換行通常能減少 AutoFit 必須過度縮小文字的情況。

**變更主題字型或觸發字型替換會影響 AutoFit 結果嗎？**  
會。替換為字型度量不同的字型會改變文字的寬度/高度，從而改變最終的字型大小與換行方式。任何字型變更或替換後，請重新檢查投影片的效果。