在簡報中以 Python 管理文字方塊

簡介

投影片上的文字通常存在於文字方塊或圖形中。因此，要在投影片上加入文字，必須先新增文字方塊，然後在文字方塊內放入文字。Aspose.Slides for Python 提供了 AutoShape 類別，允許您新增包含文字的圖形。

Info

Aspose.Slides 也提供了 Shape 類別。然而，並非所有圖形都能容納文字。

Note

因此，當處理想要加入文字的圖形時，您可能需要檢查並確認它是透過 AutoShape 類別轉型的。只有這樣，才能使用屬於 AutoShape 的 TextFrame。請參閱本頁面的 Update Text 章節。

在投影片上建立文字方塊

要在投影片上建立文字方塊：

1. 建立 Presentation 類別的實例。
2. 取得第一張投影片的參考。
3. 在投影片上所需位置新增一個 ShapeType.RECTANGLE 的 AutoShape。
4. 設定圖形的 TextFrame 內的文字。
5. 將簡報儲存為 PPTX 檔案。

以下 Python 範例實作上述步驟：

import aspose.slides as slides

# 實例化 Presentation 類別。
with slides.Presentation() as presentation:

    # 取得簡報中的第一張投影片。
    slide = presentation.slides[0]

    # 新增類型為 RECTANGLE 的 AutoShape。
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 75, 150, 50)

    shape.text_frame.text = "Aspose TextBox"

    # 將簡報儲存至磁碟。
    presentation.save("TextBox.pptx", slides.export.SaveFormat.PPTX)

檢查圖形是否為文字方塊

Aspose.Slides 在 AutoShape 類別上提供了 is_text_box 屬性，讓您能判斷圖形是否為文字方塊。

此 Python 範例說明如何檢查圖形是否以文字方塊建立：

import aspose.slides as slides

with slides.Presentation("Sample.pptx") as presentation:
    for slide in presentation.slides:
        for shape in slide.shapes:
            if isinstance(shape, slides.AutoShape):
                print("shape is a text box" if shape.is_text_box else "shape is not a text box")

請注意，如果使用 ShapeCollection 類別新增 AutoShape，該圖形的 is_text_box 屬性會回傳 False。然而，在您新增文字後─無論是使用 add_text_frame 方法或設定 text 屬性─is_text_box 會回傳 True。

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape1 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 40)
    # shape1.is_text_box 為 false
    shape1.add_text_frame("shape 1")
    # shape1.is_text_box 為 true

    shape2 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 110, 100, 40)
    # shape2.is_text_box 為 false
    shape2.text_frame.text = "shape 2"
    # shape2.is_text_box 為 true

    shape3 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 210, 100, 40)
    # shape3.is_text_box 為 false
    shape3.add_text_frame("")
    # shape3.is_text_box 為 false

    shape4 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 310, 100, 40)
    # shape4.is_text_box 為 false
    shape4.text_frame.text = ""
    # shape4.is_text_box 為 false

在文字方塊中加入欄位

Aspose.Slides 在 TextFrameFormat 類別上提供了 column_count 與 column_spacing 屬性，用於在文字方塊中加入欄位。您可以指定欄位數量並設定欄位之間的間距（以點為單位）。

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

import aspose.slides as slides

with slides.Presentation() as presentation:

	# 取得簡報中的第一張投影片。
	slide = presentation.slides[0]

	# 新增類型為 RECTANGLE 的 AutoShape。
	shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 300, 300)

	# 為矩形新增 TextFrame。
	shape.add_text_frame("All of these columns are confined to a single text container—" +
	"you can add or delete text, and any new or remaining text automatically reflows " +
	"within the container. You cannot have text flow from one container to another, " +
	"though—PowerPoint’s column options for text are limited!")

	# 取得 TextFrame 的文字格式。
	format = shape.text_frame.text_frame_format

	# 指定 TextFrame 中的欄位數量。
	format.column_count = 3

	# 指定欄位之間的間距。
	format.column_spacing = 10

	# 儲存簡報。
	presentation.save("ColumnCount.pptx", slides.export.SaveFormat.PPTX)

更新文字

Aspose.Slides 允許您更新單一文字方塊或整個簡報中的文字。

以下 Python 範例示範如何更新簡報中所有文字：

import aspose.slides as slides

with slides.Presentation("Sample.pptx") as presentation:
    for slide in presentation.slides:
        for shape in slide.shapes:
            if type(shape) is slides.AutoShape:
                for paragraph in shape.text_frame.paragraphs:
                    for portion in paragraph.portions:
                        portion.text = portion.text.replace("years", "months")
                        portion.portion_format.font_bold = 1
  
    # 儲存修改後的簡報。
    presentation.save("TextChanged.pptx", slides.export.SaveFormat.PPTX)

新增帶有超連結的文字方塊

您可以在文字方塊中插入連結。點擊文字方塊時，會開啟該連結。

要新增包含超連結的文字方塊，請遵循以下步驟：

1. 建立 Presentation 類別的實例。
2. 取得第一張投影片的參考。
3. 在投影片上所需位置新增一個 ShapeType.RECTANGLE 的 AutoShape。
4. 設定圖形的 TextFrame 內的文字。
5. 取得 HyperlinkManager 的參考。
6. 使用 hyperlink_manager 屬性設定外部點擊超連結。
7. 將簡報儲存為 PPTX 檔案。

此 Python 範例說明如何在投影片上加入帶有超連結的文字方塊：

import aspose.slides as slides

# 實例化 Presentation 類別。
with slides.Presentation() as presentation:

    # 取得簡報中的第一張投影片。
    slide = presentation.slides[0]

    # 新增類型為 RECTANGLE 的 AutoShape。
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 150, 150, 50)

    text_portion = shape.text_frame.paragraphs[0].portions[0]

    # 為框架新增文字。
    text_portion.text = "Aspose.Slides"

    # 為文字段落設定超連結。
    hyperlink_manager = text_portion.portion_format.hyperlink_manager
    hyperlink_manager.set_external_hyperlink_click("http://www.aspose.com")

    # 將簡報儲存為 PPTX 檔案。
    presentation.save("Hyperlink.pptx", slides.export.SaveFormat.PPTX)

常見問題

在使用母片時，文字方塊與文字占位符有何不同？

A placeholder 會從 master 繼承樣式/位置，且可在 layouts 上覆寫；相較之下，普通文字方塊是特定投影片上的獨立物件，切換版面配置時不會改變。

如何在不影響圖表、表格與 SmartArt 內文字的情況下，對整個簡報執行批次文字取代？

將迭代限制於具有文字框的 auto‑shape，並排除內嵌物件（charts、tables、SmartArt），可分別遍歷其集合或直接跳過這些物件類型。