在 Python 中管理 PowerPoint 文本段落

本页内容简介

了解如何使用 Aspose.Slides for Python via .NET 创建和格式化段落、文本片段、项目符号、编号列表、缩进、HTML 内容以及段落图像。

概述

Aspose.Slides for Python via .NET 将文本表示为文本框、段落和文本片段的层次结构：

TextFrame 表示形状中的文本容器，并提供对其段落集合的访问。
Paragraph 表示文本框中的一个段落，并提供对其文本片段和段落级格式的访问。
Portion 表示段落中的一次文本运行。每个文本片段可以拥有自己的文本和字符级格式。

因此，一个段落可以通过使用多个文本片段来包含不同字体、颜色、大小和其他格式的文本。

创建并格式化段落

创建包含多个文本片段的段落

以下步骤创建一个包含三个段落的文本框，每个段落包含三个文本片段：

创建 Presentation 类的实例。
通过索引访问相应的幻灯片。
向幻灯片添加一个矩形 AutoShape。
访问形状的 TextFrame。
使用默认段落并向文本框再添加两个 Paragraph 对象。
为每个段落添加足够的 Portion 对象，以包含三个文本片段。默认段落已包含一个空的文本片段。
设置每个文本片段的文本。
通过 Portion.portion_format 应用字符级格式。
保存修改后的演示文稿。

下面的 Python 示例实现了这些步骤：

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 150, 300, 150)
    text_frame = shape.text_frame

    first_paragraph = text_frame.paragraphs[0]
    first_paragraph.portions.add(slides.Portion())
    first_paragraph.portions.add(slides.Portion())

    second_paragraph = slides.Paragraph()
    second_paragraph.portions.add(slides.Portion())
    second_paragraph.portions.add(slides.Portion())
    second_paragraph.portions.add(slides.Portion())
    text_frame.paragraphs.add(second_paragraph)

    third_paragraph = slides.Paragraph()
    third_paragraph.portions.add(slides.Portion())
    third_paragraph.portions.add(slides.Portion())
    third_paragraph.portions.add(slides.Portion())
    text_frame.paragraphs.add(third_paragraph)

    for paragraph_index in range(text_frame.paragraphs.count):
        paragraph = text_frame.paragraphs[paragraph_index]
        for portion_index in range(paragraph.portions.count):
            portion = paragraph.portions[portion_index]
            portion.text = f"Portion {paragraph_index + 1}.{portion_index + 1}"

            if portion_index == 0:
                portion.portion_format.fill_format.fill_type = slides.FillType.SOLID
                portion.portion_format.fill_format.solid_fill_color.color = draw.Color.red
                portion.portion_format.font_bold = slides.NullableBool.TRUE
                portion.portion_format.font_height = 15
            elif portion_index == 1:
                portion.portion_format.fill_format.fill_type = slides.FillType.SOLID
                portion.portion_format.fill_format.solid_fill_color.color = draw.Color.blue
                portion.portion_format.font_italic = slides.NullableBool.TRUE
                portion.portion_format.font_height = 18

    presentation.save("paragraphs_with_portions.pptx", slides.export.SaveFormat.PPTX)

创建项目符号和编号列表

创建项目符号或编号列表

项目符号和编号可以让相关项目更易于浏览。在 Aspose.Slides 中，列表设置通过 BulletFormat 定义。

创建 Presentation 类的实例。
通过索引访问相应的幻灯片。
向选定的幻灯片添加一个 AutoShape。
访问形状的 TextFrame。
从文本框中移除默认段落。
为符号项目符号创建一个 Paragraph。
将 BulletFormat.type 设置为 BulletType.SYMBOL 并指定项目符号字符。
设置段落文本、缩进、项目符号颜色和项目符号高度。
将段落添加到文本框。
创建第二个段落并将 BulletFormat.type 设置为 BulletType.NUMBERED。
配置编号项目符号样式并将段落添加到文本框。
保存演示文稿。

下面的 Python 示例创建了符号项目符号和编号项目符号：

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)
    text_frame = shape.text_frame
    text_frame.paragraphs.clear()

    symbol_paragraph = slides.Paragraph()
    symbol_paragraph.text = "Welcome to Aspose.Slides"
    symbol_paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    symbol_paragraph.paragraph_format.bullet.char = chr(0x2022)
    symbol_paragraph.paragraph_format.indent = 25
    symbol_paragraph.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
    symbol_paragraph.paragraph_format.bullet.color.color = draw.Color.black
    symbol_paragraph.paragraph_format.bullet.is_bullet_hard_color = slides.NullableBool.TRUE
    symbol_paragraph.paragraph_format.bullet.height = 100
    text_frame.paragraphs.add(symbol_paragraph)

    numbered_paragraph = slides.Paragraph()
    numbered_paragraph.text = "This is a numbered item"
    numbered_paragraph.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    numbered_paragraph.paragraph_format.bullet.numbered_bullet_style = slides.NumberedBulletStyle.BULLET_CIRCLE_NUM_WD_BLACK_PLAIN
    numbered_paragraph.paragraph_format.indent = 25
    numbered_paragraph.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
    numbered_paragraph.paragraph_format.bullet.color.color = draw.Color.black
    numbered_paragraph.paragraph_format.bullet.is_bullet_hard_color = slides.NullableBool.TRUE
    numbered_paragraph.paragraph_format.bullet.height = 100
    text_frame.paragraphs.add(numbered_paragraph)

    presentation.save("bulleted_and_numbered_list.pptx", slides.export.SaveFormat.PPTX)

使用图片项目符号

图片项目符号允许使用自定义图像而不是符号或数字。

创建 Presentation 类的实例。
通过索引访问相应的幻灯片。
添加一个 AutoShape 并访问其 TextFrame。
从文本框中移除默认段落。
加载项目符号图片并将其作为 PPImage 添加到演示文稿的图像集合中。
创建一个 Paragraph 并设置其文本。
将 BulletFormat.type 设置为 BulletType.PICTURE。
通过 BulletFormat.picture 分配图像并设置项目符号高度。
将段落添加到文本框。
保存修改后的演示文稿。

下面的 Python 示例创建了图片项目符号：

import aspose.slides as slides

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

    with slides.Images.from_file("bullets.png") as bullet_image:
        presentation_image = presentation.images.add_image(bullet_image)

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)
    text_frame = shape.text_frame
    text_frame.paragraphs.clear()

    paragraph = slides.Paragraph()
    paragraph.text = "Welcome to Aspose.Slides"
    paragraph.paragraph_format.bullet.type = slides.BulletType.PICTURE
    paragraph.paragraph_format.bullet.picture.image = presentation_image
    paragraph.paragraph_format.bullet.height = 100
    text_frame.paragraphs.add(paragraph)

    presentation.save("picture_bullet.pptx", slides.export.SaveFormat.PPTX)
    presentation.save("picture_bullet.ppt", slides.export.SaveFormat.PPT)

创建多级列表

将 ParagraphFormat.depth 设置为不同的深度，以在列表中放置不同层级的段落。顶层的深度为 0。

创建一个 Presentation 并访问某个幻灯片。
添加一个 AutoShape 并清除其文本框中的默认段落。
创建四个段落并配置它们的项目符号符号。
将它们的 ParagraphFormat.depth 值分别设为 0、1、2 和 3。
将段落添加到文本框并保存演示文稿。

下面的 Python 示例创建了四级项目符号列表：

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)
    text_frame = shape.text_frame
    text_frame.paragraphs.clear()

    first_paragraph = slides.Paragraph()
    first_paragraph.text = "Content"
    first_paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    first_paragraph.paragraph_format.bullet.char = chr(0x2022)
    first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    first_paragraph.paragraph_format.depth = 0

    second_paragraph = slides.Paragraph()
    second_paragraph.text = "Second level"
    second_paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    second_paragraph.paragraph_format.bullet.char = "-"
    second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    second_paragraph.paragraph_format.depth = 1

    third_paragraph = slides.Paragraph()
    third_paragraph.text = "Third level"
    third_paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    third_paragraph.paragraph_format.bullet.char = chr(0x2022)
    third_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    third_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    third_paragraph.paragraph_format.depth = 2

    fourth_paragraph = slides.Paragraph()
    fourth_paragraph.text = "Fourth level"
    fourth_paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    fourth_paragraph.paragraph_format.bullet.char = "-"
    fourth_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    fourth_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    fourth_paragraph.paragraph_format.depth = 3

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)
    text_frame.paragraphs.add(third_paragraph)
    text_frame.paragraphs.add(fourth_paragraph)

    presentation.save("multilevel_list.pptx", slides.export.SaveFormat.PPTX)

自定义编号列表起始值

使用 BulletFormat.numbered_bullet_start_with 设置编号段落的初始数字。

创建一个 Presentation 并向幻灯片添加一个 AutoShape。
清除形状文本框中的默认段落。
创建三个编号段落。
将 BulletFormat.numbered_bullet_start_with 分别设置为 2、3 和 7。
将段落添加到文本框并保存演示文稿。

下面的 Python 示例为每个段落分配了自定义起始编号：

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)
    text_frame = shape.text_frame
    text_frame.paragraphs.clear()

    first_paragraph = slides.Paragraph()
    first_paragraph.text = "Start at 2"
    first_paragraph.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    first_paragraph.paragraph_format.bullet.numbered_bullet_start_with = 2
    text_frame.paragraphs.add(first_paragraph)

    second_paragraph = slides.Paragraph()
    second_paragraph.text = "Start at 3"
    second_paragraph.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    second_paragraph.paragraph_format.bullet.numbered_bullet_start_with = 3
    text_frame.paragraphs.add(second_paragraph)

    third_paragraph = slides.Paragraph()
    third_paragraph.text = "Start at 7"
    third_paragraph.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    third_paragraph.paragraph_format.bullet.numbered_bullet_start_with = 7
    text_frame.paragraphs.add(third_paragraph)

    presentation.save("custom_numbered_list.pptx", slides.export.SaveFormat.PPTX)

控制段落布局和结束属性

设置首行缩进

使用 ParagraphFormat.indent 属性控制段落的首行缩进。此属性仅移动首行相对于段落左边距的距离。正值会将首行向右移动，剩余行保持与段落正文对齐。

需要整体移动段落时请使用 ParagraphFormat.margin_left。仅需移动首行时使用 ParagraphFormat.indent。

下面的示例创建多个段落，并对不同的 ParagraphFormat.indent 值进行演示，以展示首行缩进对段落布局的影响。

创建 Presentation 类的实例。
访问目标幻灯片。
向幻灯片添加一个矩形 AutoShape。
访问形状的 TextFrame 并移除默认段落。
创建若干段落并为它们设置不同的 ParagraphFormat.indent 值。
将段落添加到文本框。
保存修改后的演示文稿。

下面的代码演示了如何设置段落缩进：

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
    shape.fill_format.fill_type = slides.FillType.NO_FILL
    shape.line_format.fill_format.fill_type = slides.FillType.SOLID
    shape.line_format.fill_format.solid_fill_color.color = draw.Color.gray

    text_frame = shape.text_frame
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
    text_frame.paragraphs.clear()

    first_paragraph = slides.Paragraph()
    first_paragraph.text = "No first-line indent. Wrapped lines start at the same position as the first line."
    first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    first_paragraph.paragraph_format.margin_left = 20
    first_paragraph.paragraph_format.indent = 0

    second_paragraph = slides.Paragraph()
    second_paragraph.text = "First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body."
    second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    second_paragraph.paragraph_format.margin_left = 20
    second_paragraph.paragraph_format.indent = 20

    third_paragraph = slides.Paragraph()
    third_paragraph.text = "First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see."
    third_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    third_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    third_paragraph.paragraph_format.margin_left = 20
    third_paragraph.paragraph_format.indent = 40

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)
    text_frame.paragraphs.add(third_paragraph)

    presentation.save("paragraph_indent.pptx", slides.export.SaveFormat.PPTX)

结果：

The first-line indent of the paragraphs

设置悬挂缩进

悬挂缩进是一种段落布局，其中首行位于其余行的左侧。在 Aspose.Slides 中，可通过 ParagraphFormat.indent 属性实现。将 indent 设置为负值即可使首行相对于段落正文向左移动。

实际使用时，ParagraphFormat.margin_left 定义段落正文的左侧位置，而 ParagraphFormat.indent 定义首行相对于该左边距的位置。要创建悬挂缩进，需将 margin_left 设置为正值，并将 indent 设置为负值。

此格式常用于书目、参考文献、词汇表等需要换行后对齐到段落正文而非首字符的段落。

创建 Presentation 类的实例。
访问目标幻灯片。
向幻灯片添加一个矩形 AutoShape。
访问形状的 TextFrame 并移除默认段落。
为每个段落创建并设置正的 ParagraphFormat.margin_left 值。
将负的 ParagraphFormat.indent 值用于实现悬挂缩进效果。
将段落添加到文本框。
保存修改后的演示文稿。

下面的代码演示了如何为段落设置悬挂缩进：

import aspose.pydrawing as draw
import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
    shape.fill_format.fill_type = slides.FillType.NO_FILL
    shape.line_format.fill_format.fill_type = slides.FillType.SOLID
    shape.line_format.fill_format.solid_fill_color.color = draw.Color.gray

    text_frame = shape.text_frame
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
    text_frame.paragraphs.clear()

    first_paragraph = slides.Paragraph()
    first_paragraph.text = "A hanging indent is created by combining a positive left margin with a negative indent. The first line starts to the left, while wrapped lines align with the paragraph body."
    first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    first_paragraph.paragraph_format.margin_left = 40
    first_paragraph.paragraph_format.indent = -20

    second_paragraph = slides.Paragraph()
    second_paragraph.text = "This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare."
    second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    second_paragraph.paragraph_format.margin_left = 60
    second_paragraph.paragraph_format.indent = -30

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)

    presentation.save("hanging_indent.pptx", slides.export.SaveFormat.PPTX)

结果：

The hanging indent of the paragraphs

设置段落结束运行属性

Paragraph.end_paragraph_portion_format 属性控制段落结束标记的格式。下面的示例为第二段落的结束标记分配了字体大小和西文字体：

加载一个 Presentation 并访问某个幻灯片。
添加一个 AutoShape 并清除其默认段落。
创建两个段落并向其添加文本片段。
为第二段落的结束标记创建一个 PortionFormat。
设置 PortionFormat.font_height 和 PortionFormat.latin_font。
将该格式分配给 Paragraph.end_paragraph_portion_format 并保存演示文稿。

import aspose.slides as slides

with slides.Presentation("Test.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 200, 250)
    text_frame = shape.text_frame
    text_frame.paragraphs.clear()

    first_paragraph = slides.Paragraph()
    first_paragraph.portions.add(slides.Portion("Sample text"))

    second_paragraph = slides.Paragraph()
    second_paragraph.portions.add(slides.Portion("Sample text 2"))

    end_paragraph_format = slides.PortionFormat()
    end_paragraph_format.font_height = 48
    end_paragraph_format.latin_font = slides.FontData("Times New Roman")
    second_paragraph.end_paragraph_portion_format = end_paragraph_format

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)

    presentation.save("end_paragraph_format.pptx", slides.export.SaveFormat.PPTX)

导入和导出段落内容

将 HTML 文本导入段落

使用 ParagraphCollection.add_from_html 将 HTML 标记转换为文本框中的段落和文本片段。

创建 Presentation 类的实例。
访问某个幻灯片并添加一个 AutoShape。
访问形状的 TextFrame 并清除默认段落。
读取源 HTML 文件。
将 HTML 字符串传递给 ParagraphCollection.add_from_html。
保存修改后的演示文稿。

下面的 Python 示例将 HTML 导入文本框：

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape_width = presentation.slide_size.size.width - 20
    shape_height = presentation.slide_size.size.height - 20
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, shape_width, shape_height)
    shape.fill_format.fill_type = slides.FillType.NO_FILL
    shape.text_frame.paragraphs.clear()

    with open("file.html", "r", encoding="utf-8") as html_stream:
        html = html_stream.read()

    shape.text_frame.paragraphs.add_from_html(html)
    presentation.save("html_text.pptx", slides.export.SaveFormat.PPTX)

将段落文字导出为 HTML

使用 ParagraphCollection.export_to_html 将选定范围的段落导出为 HTML。

创建 Presentation 类的实例并加载所需的演示文稿。
访问幻灯片并找到包含文本的 AutoShape。
访问形状的 TextFrame。
调用 ParagraphCollection.export_to_html 并传入起始段落索引和要导出的段落数量。
将返回的 HTML 字符串写入文件。

下面的 Python 示例导出第一个文本形状中的所有段落：

import aspose.slides as slides

with slides.Presentation("ExportingHTMLText.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]

    if isinstance(shape, slides.AutoShape) and shape.text_frame is not None:
        paragraphs = shape.text_frame.paragraphs
        html = paragraphs.export_to_html(0, paragraphs.count, None)
        with open("paragraphs.html", "w", encoding="utf-8") as html_stream:
            html_stream.write(html)
    else:
        print("The first shape is not a text shape.")

将段落渲染为图像

Paragraph 提供 get_image 方法，可直接渲染单个段落。该方法返回一个 IImage，您可以使用 IImage.save 将其保存为文件或流，无需渲染包含的形状或手动裁剪位图。

如果段落在其父集合中找不到、没有有效的渲染边界或无法渲染，get_image 方法可能返回 None。在保存之前请检查返回结果，并使用返回的图像作为上下文管理器以释放资源。

以默认比例渲染段落

假设我们有一个名为 sample.pptx 的演示文稿，只有一张幻灯片，第一形状是包含三个段落的文本框。

The text box with three paragraphs

以下示例在默认比例下渲染文本形状中的第二段落，并以 PNG 格式保存返回的图像：

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    shape = presentation.slides[0].shapes[0]

    if isinstance(shape, slides.AutoShape) and shape.text_frame is not None and shape.text_frame.paragraphs.count > 1:
        paragraph = shape.text_frame.paragraphs[1]
        paragraph_image = paragraph.get_image()

        if paragraph_image is not None:
            with paragraph_image:
                paragraph_image.save("paragraph.png", slides.ImageFormat.PNG)
        else:
            print("The paragraph could not be rendered.")
    else:
        print("The expected text shape or paragraph was not found.")

结果：

The paragraph image

在表格单元格中渲染段落并进行缩放

向 get_image 传递水平和垂直缩放因子，可控制渲染段落的大小。以下示例创建一个表格，在其第一个单元格中以默认宽高的两倍渲染段落，并将结果保存为 PNG 图像：

import aspose.slides as slides

scale_x = 2
scale_y = 2

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    table = slide.shapes.add_table(50, 50, [300], [80])
    paragraph = table.rows[0][0].text_frame.paragraphs[0]
    paragraph.text = "Text in a table cell"

    paragraph_image = paragraph.get_image(scale_x, scale_y)
    if paragraph_image is not None:
        with paragraph_image:
            paragraph_image.save("table_paragraph.png", slides.ImageFormat.PNG)
    else:
        print("The paragraph could not be rendered.")

缩放因子 1 表示保持该轴的默认像素大小。例如，水平和垂直因子都为 2 时，生成的图像宽高约为默认尺寸的两倍，像素数约为四倍。较大的因子通常可获得更清晰的文本，适用于放大或高分辨率输出，但也会增加内存使用和文件大小。因子小于 1 会生成更小、细节更少的图像。使用相同的水平和垂直因子可保持段落的纵横比；使用不同的因子会独立拉伸输出。

在需要包含形状填充、边框或其他视觉上下文时，仍可使用 Shape.get_image 渲染整个形状。若只需段落图像，请使用 Paragraph.get_image。

常见问题

我能完全禁用文本框内的自动换行吗？

可以。将 TextFrameFormat.wrap_text 设置为 False，即可禁用换行，使行不会在文本框边缘断开。

如何获取特定段落在幻灯片上的准确边界？

使用 Paragraph.get_rect 获取段落的边界矩形。单个文本片段的边界可通过 Portion.get_rect 获得。

段落对齐方式（左、右、居中或两端对齐）在哪里控制？

ParagraphFormat.alignment 是段落级别的设置，适用于整个段落，而不受单个文本片段格式的影响。

我可以为段落的一部分设置校对语言吗？

可以。为各个文本片段设置 PortionFormat.language_id，即可在同一段落中包含多种语言的文本。

使用 Python 中的 AutoFit 提升您的演示文稿获取 Python 演示文稿中的段落边界