# 在 Java 中管理簡報佔位符

> 輕鬆在 Aspose.Slides for Java 中管理佔位符：替換文字、客製化提示並設定 PowerPoint 與 OpenDocument 中的影像透明度。

Source: https://docs.aspose.com/slides/zh-hant/java/manage-placeholder/


## **概觀**

Aspose.Slides 允許您以程式方式管理簡報的佔位符。本文說明如何在投影片上找到佔位符並變更其文字、為佔位符版面配置設定自訂提示文字，以及調整用作佔位符背景的圖片的透明度。本文亦包含簡短 FAQ，說明基礎佔位符與投影片本機圖形的差異、佔位符變更如何透過版面配置或母片套用，並指向頁首與頁尾佔位符的管理方式。

## **變更佔位符文字**
使用 [Aspose.Slides for Java](/slides/zh-hant/java/)，您可以在簡報的投影片上找到並修改佔位符。Aspose.Slides 允許您變更佔位符中的文字。

**先決條件**：您需要一個包含佔位符的簡報。您可以使用標準的 Microsoft PowerPoint 應用程式建立此類簡報。

1. 建立 [`Presentation`](https://reference.aspose.com/slides/zh-hant/java/com.aspose.slides/Presentation) 類別的實例，並將簡報作為參數傳入。  
2. 透過索引取得投影片參考。  
3. 逐一遍歷圖形以尋找佔位符。  
4. 將佔位符圖形型別轉換為 [`AutoShape`](https://reference.aspose.com/slides/zh-hant/java/com.aspose.slides/AutoShape)，並使用與該 [`AutoShape`](https://reference.aspose.com/slides/zh-hant/java/com.aspose.slides/AutoShape) 相關聯的 [`TextFrame`](https://reference.aspose.com/slides/zh-hant/java/com.aspose.slides/TextFrame) 來變更文字。  
5. 儲存已修改的簡報。

以下 Java 程式碼示範如何變更佔位符中的文字：

```java
// 實例化 Presentation 類別
Presentation pres = new Presentation("ReplacingText.pptx");
try {

    // 存取第一張投影片
    ISlide sld = pres.getSlides().get_Item(0);

    // 遍歷圖形以尋找佔位符
    for (IShape shp : sld.getShapes()) 
    {
        if (shp.getPlaceholder() != null) {
            // 變更每個佔位符中的文字
            ((IAutoShape) shp).getTextFrame().setText("This is Placeholder");
        }
    }

    // 將簡報存檔至磁碟
    pres.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
```

## **在佔位符中設定提示文字**
標準及預先建好的版面配置包含像是 ***Click to add a title*** 或 ***Click to add a subtitle*** 的佔位符提示文字。使用 Aspose.Slides，您可以將自訂的提示文字插入佔位符版面配置中。

以下 Java 程式碼示範如何在佔位符中設定提示文字：

```java
Presentation pres = new Presentation("Presentation.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    for (IShape shape : slide.getSlide().getShapes()) // 遍歷投影片
    {
        if (shape.getPlaceholder() != null && shape instanceof AutoShape)
        {
            String text = "";
            if (shape.getPlaceholder().getType() == PlaceholderType.CenteredTitle) // PowerPoint 顯示「按一下新增標題」 
            {
                text = "Add Title";
            }
            else if (shape.getPlaceholder().getType() == PlaceholderType.Subtitle) // 新增副標題
            {
                text = "Add Subtitle";
            }

            ((IAutoShape)shape).getTextFrame().setText(text);
            System.out.println("Placeholder with text: " + text);
        }
    }

    pres.save("Placeholders_PromptText.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
```

## **設定佔位符圖片透明度**

Aspose.Slides 允許您設定文字佔位符背景圖片的透明度。透過調整此框架中圖片的透明度，可以讓文字或圖片更為突出（取決於文字與圖片的顏色）。

以下 Java 程式碼示範如何為圖片背景（形狀內部）設定透明度：

```java
Presentation presentation = new Presentation("example.pptx");

IAutoShape shape = (IAutoShape) presentation.getSlides().get_Item(0).getShapes().get_Item(0);

IImageTransformOperationCollection operationCollection = shape.getFillFormat().getPictureFillFormat().getPicture().getImageTransform();
for (int i = 0; i < operationCollection.size(); i++)
{
    if(operationCollection.get_Item(i) instanceof AlphaModulateFixed)
    {
        AlphaModulateFixed alphaModulate = (AlphaModulateFixed)operationCollection.get_Item(i);
        float currentValue = 100 - alphaModulate.getAmount();
        System.out.println("Current transparency value: " + currentValue);

        int alphaValue = 40;
        alphaModulate.setAmount(100 - alphaValue);
    }
}

presentation.save("example_out.pptx", SaveFormat.Pptx);
```

## **FAQ**

**什麼是基礎佔位符，它與投影片上的本機圖形有何不同？**

基礎佔位符是版面配置或母片上原始的圖形，投影片的圖形會從其繼承類型、位置以及部分格式設定。本機圖形則是獨立的；若不存在基礎佔位符，則不會有繼承關係。

**如何在不逐一遍歷每張投影片的情況下，更新整個簡報中的所有標題或說明文字？**

只需編輯版面配置或母片上對應的佔位符。基於該版面配置/母片的投影片會自動繼承此變更。

**如何控制標準的頁首/頁尾佔位符——日期與時間、投影片編號與頁尾文字？**

使用適當範圍（普通投影片、版面配置、母片、備註/講義）的 HeaderFooter 管理器，開啟或關閉這些佔位符，並設定其內容。