在 Python 中管理 PowerPoint 文本段落

概览

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

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

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

创建和格式化段落

在形状的文本框中创建段落,并使用文本段来格式化各个文本运行。本节展示如何在每个段落中组合多个文本段,并应用不同的颜色、字体大小和样式。

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

以下 Python 示例创建了三个段落,每个段落在其 Paragraph.portions 集合中包含三个文本运行。它复用默认段落及其空文本段,然后添加其余的段落和文本段。格式通过 Portion.portion_format 应用:每个段落的第一个文本段为红色、粗体、15 磅;第二个为蓝色、斜体、18 磅。第三个文本段保留默认格式:

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 定义。

此 Python 示例在同一文本框中添加了符号项目符号和编号项。BulletFormat.type 选择项目符号类型,而 BulletFormat.char 提供符号,BulletFormat.numbered_bullet_style 选择编号样式。两项均使用黑色项目符号,大小为 100%,段落缩进为 25 磅:

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)

使用图片项目符号

图片项目符号允许使用自定义图像替代符号或数字。

示例需要工作目录中存在 bullets.png。此 Python 示例将图像添加到演示文稿的图像集合中,作为 PPImage,并将其用作段落项目符号。它将 BulletFormat.type 设置为使用图片项目符号,并通过 BulletFormat.picture 分配图像。BulletFormat.height 设置为 100%,以相对段落文本的大小调整项目符号:

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。

此 Python 示例为四个段落分配从 0 到 3 的 ParagraphFormat.depth 值,在同一文本框中创建层级结构。每个段落使用符号项目符号,BulletFormat.char 在圆形项目符号和连字符之间交替,以区分相邻层级:

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 设置编号段落的初始显示号码。

此 Python 示例将 BulletFormat.type 设置为对三个段落使用编号,并为 BulletFormat.numbered_bullet_start_with 分别赋值 2、3、7。每个段落的起始值单独配置,使显示的编号可跳过某些值:

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.margin_left 为 20 磅,以及 ParagraphFormat.indent 为 0、20、40 磅。首行的起始位置逐步增大,而换行行保持相同的左边距:

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)

结果:

段落的首行缩进

设置悬挂缩进

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

实际使用时,ParagraphFormat.margin_left 定义段落正文的左侧位置,ParagraphFormat.indent 定义首行相对于该边距的位置。要创建悬挂缩进,需将正的 margin_left 与负的 indent 组合使用。

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

下面的 Python 示例将 ParagraphFormat.margin_left 设置为 40 和 60 磅,分别配合 ParagraphFormat.indent 为 -20 和 -30 磅。在每个段落中,首行位于换行行的左侧;第二个段落的悬挂缩进更深:

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)

结果:

段落的悬挂缩进

设置段落结束运行属性

Paragraph.end_paragraph_portion_format 属性控制段落结束标记的格式。示例加载 Test.pptx(该文件必须至少包含一张幻灯片),并创建一个 PortionFormat ,将 PortionFormat.font_height 设为 48 磅,PortionFormat.latin_font 设为 Times New Roman。随后将此格式分配给第二段落的结束标记,保持可见文本段不变:

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)

统计渲染行数

有关影响自动换行和行尾标点的段落规则,请参阅 控制换行 和 控制悬挂标点。

使用 Paragraph.get_lines_count 可统计段落在文本布局后占用的行数,包括自动换行。这在检查演示文稿模板中文本长度和布局时非常有用。

段落是 TextFrame.paragraphs 中的一个项目,可能占据多行已渲染的文本。段落内部的显式换行会强制另起一行,但不会创建新段落。自动换行根据可用宽度生成行,而不会在文本中插入显式换行字符。因此,仅统计段落或换行字符并不能得到已渲染的行数。

下面的示例创建一个文本形状,统计其行数,随后缩窄形状,再用更短的字符串替换文本。示例启用 TextFrameFormat.wrap_text 并禁用 TextFrameFormat.autofit_type,使形状宽度控制换行而不自动缩小文本或调整形状大小。每次测量均使用 Paragraph.get_lines_count。形状尺寸以磅为单位。最后,示例在文本框中再添加一个段落,并对所有段落的行数求和。

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, 400, 200)
    text_frame = shape.text_frame
    text_frame.text_frame_format.wrap_text = slides.NullableBool.TRUE
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE

    paragraph = text_frame.paragraphs[0]
    paragraph.paragraph_format.default_portion_format.font_height = 20
    paragraph.text = "This text demonstrates how automatic wrapping changes the number of rendered lines."
    print(f"Original width: {paragraph.get_lines_count()}")

    shape.width = 150
    print(f"Narrower shape: {paragraph.get_lines_count()}")

    paragraph.text = "Short text."
    print(f"Shorter text: {paragraph.get_lines_count()}")

    second_paragraph = slides.Paragraph()
    second_paragraph.text = "Another paragraph."
    second_paragraph.paragraph_format.default_portion_format.font_height = 20
    text_frame.paragraphs.add(second_paragraph)

    total_line_count = 0
    for current_paragraph in text_frame.paragraphs:
        total_line_count += current_paragraph.get_lines_count()
    print(f"Total lines in the text frame: {total_line_count}")

使用这些文本和尺寸时,缩窄形状会增加行数,而将文本替换为短字符串会减少行数。具体计数可能因字体可用性与替代、字体大小、边距、缩进、换行和自动适应设置而异。检查模板时请使用目标环境的字体和布局设置。

仅凭行数并不能判断文本是否溢出容器。可用高度、行高、段落和行间距以及自动适应行为同样重要;即使是一行文本,在禁用换行时也可能超过可用宽度。

导入和导出段落内容

使用 HTML 将文本导入演示文稿,或将现有段落导出以供外部使用。本节还展示如何将单个段落渲染为图像,包括表格单元格中的段落。

将 HTML 文本导入段落

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

此 Python 示例从工作目录下的 file.html 读取 HTML,并将标记传递给 ParagraphCollection.add_from_html。它清除文本框的默认段落,使框中仅包含导入的内容。矩形形状在幻灯片的每一侧留下 10 磅的边距:

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。当在网站上复用演示文稿文本时,可能希望保留局部强调,但不带入演示文稿的字体、大小或文本框样式。将 TextToHtmlConversionOptions.text_inheritance_limit 设置为控制导出器遵循格式继承的层级深度。

下载 示例演示文稿 并放置在应用程序的工作目录中。其第一张幻灯片包含一个文本形状,文本为 “Inherited text; explicit red 18pt”。输入特意使用了多个格式层级:

  • 演示文稿的默认文本样式提供 Calibri 字体,大小为 28 pt。
  • 文本框的一级文本样式提供蓝色文本和斜体。
  • 段落显式设置为粗体。
  • 第二个文本段 “explicit red 18pt” 显式设置为红色文本,大小为 18 pt。

下面的完整示例将相同的段落导出三次。它将 TextToHtmlConversionOptions 传递给导出方法,并将每个结果写入单独的 UTF-8 HTML 文件:

import aspose.slides as slides

with slides.Presentation("text-inheritance.pptx") as presentation:
    text_shape = presentation.slides[0].shapes[0]
    paragraphs = text_shape.text_frame.paragraphs
    
    modes = {
        "All": slides.export.TextInheritanceLimit.ALL,
        "TextBox": slides.export.TextInheritanceLimit.TEXT_BOX,
        "ParagraphOnly": slides.export.TextInheritanceLimit.PARAGRAPH_ONLY,
    }

    for name, mode in modes.items():
        options = slides.export.TextToHtmlConversionOptions()
        options.text_inheritance_limit = mode

        html = paragraphs.export_to_html(0, paragraphs.count, options)
        with open(f"{name}.html", "w", encoding="utf-8") as html_stream:
            html_stream.write(html)

生成的 HTML 包含以下 CSS,针对第一段 “Inherited text; ”。表格列出了相关声明,其他生成属性为清晰起见已省略。

输出 第一段的相关 CSS 外观
All.html font-family:'Calibri'; font-size:28pt; color:#0000ff; font-style:italic; font-weight:bold 蓝色、粗体、斜体,28 pt,Calibri(若该字体可用)。
TextBox.html color:#0000ff; font-style:italic; font-weight:bold 蓝色、粗体、斜体;页面或浏览器提供字体族和大小。
ParagraphOnly.html font-weight:bold 粗体;页面或浏览器提供字体族、大小、颜色和斜体样式。

第二段在所有三种输出中均保留 color:#ff0000、font-size:18pt 和 font-weight:bold。它在 ALL 和 TEXT_BOX 中也保留斜体,但在 PARAGRAPH_ONLY 中不保留。限制继承因此不会去除显式分配给段落或文本段的格式。

在相同浏览器中打开这些文件进行比较。在两种受限模式下,省略的 CSS 属性由目标页面的样式或浏览器默认值解析,因此最终外观取决于 HTML 的使用环境。

生成 HTML 剪贴板片段

ParagraphCollection.export_to_html 返回 HTML 字符串。将 TextToHtmlConversionOptions.add_clipboard_fragment_header 设置为 False 可获得普通 HTML,设置为 True 则包含 Windows 剪贴板头。该头部提供周围 HTML 的 UTF-8 字节偏移(StartHTML、EndHTML)以及要粘贴的片段偏移(StartFragment、EndFragment)。

此示例将两个格式化段落分别导出为普通 HTML(html)和 HTML 剪贴板片段(clipboard_html)。将片段写入系统剪贴板是另一步骤。如果剪贴板 API 期待原始字节,请将片段编码为 UTF-8(无 BOM)。

import aspose.slides as slides

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

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 0, 0, 400, 100)
    paragraphs = shape.text_frame.paragraphs
    paragraphs.clear()
    paragraphs.add_from_html("<p>Status: <b>Ready</b></p><p><i>Next steps</i></p>")

    options = slides.export.TextToHtmlConversionOptions()
    options.add_clipboard_fragment_header = False
    html = paragraphs.export_to_html(0, paragraphs.count, options)

    options.add_clipboard_fragment_header = True
    clipboard_html = paragraphs.export_to_html(0, paragraphs.count, options)

将段落渲染为图像

Paragraph.get_image 直接渲染单个段落并返回 IImage。使用 IImage.save 将结果保存到文件或流。无需渲染整个形状或手动裁剪位图。

如果段落在其父集合中找不到、没有有效的渲染边界或无法渲染,Paragraph.get_image 可能返回 None。在保存之前检查返回值,并在使用后释放图像资源。

在默认比例下渲染段落

示例使用 sample.pptx,该演示文稿包含一张幻灯片,第一形状是包含三个段落的文本框。

包含三个段落的文本框

下面的示例在索引为 1 的位置选取第二段落,调用 Paragraph.get_image(不传递比例参数)。它检查形状是否包含所需段落以及渲染是否返回图像,然后调用 IImage.save 将其以 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.")

结果:

段落图像

在表格单元格中按比例渲染段落

使用接受 scale_x 和 scale_y 参数的 Paragraph.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 是段落级别的设置,适用于整个段落,独立于各文本段的格式。

要在每行内部垂直对齐不同字体大小的文本段,请参阅 Align Fonts Within a Line。

我可以为段落的部分文本设置校对语言吗?

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