使用 Python 管理演示文稿中的文本框

概述

幻灯片上的文本通常位于文本框或形状中。因此，要在幻灯片上添加文本，必须先添加一个文本框，然后在文本框中放入一些文本。Aspose.Slides for Python 提供了AutoShape类，允许您添加包含文本的形状。

Info

Aspose.Slides 还提供了Shape类。然而，并非所有形状都能容纳文本。

Note

因此，在处理想要添加文本的形状时，您可能需要检查并确认它是通过AutoShape类转换的。只有这样，您才能使用TextFrame，它是AutoShape下的属性。请参阅本页的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]

    # 添加 type 为 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)

常见问答

在使用母版幻灯片时，文本框和文本占位符有什么区别？

placeholder 继承自master的样式/位置，并且可以在layouts上被覆盖，而普通文本框是特定幻灯片上的独立对象，在切换布局时不会改变。

如何在不影响图表、表格和 SmartArt 中的文本的情况下，对整个演示文稿进行批量文本替换？

将遍历限制在具有文本框的自动形状上，排除嵌入对象（charts、tables、SmartArt），可以分别遍历它们的集合或跳过这些对象类型。