使用 Python 管理演示文稿表格

本页内容简介

使用 Aspose.Slides for Python via .NET 在 PowerPoint 和 OpenDocument 幻灯片中创建和编辑表格。发现简洁的代码示例，以简化您的表格工作流程。

简介

PowerPoint 中的表格是呈现信息的高效方式。以单元格（行和列）网格方式组织的信息直观且易于理解。

Aspose.Slides 提供 Table 类、Cell 类以及其他相关类型，帮助您在任何演示文稿中创建、更新和管理表格。

从头创建表格

本节展示如何通过向幻灯片添加表格形状、定义行列并设置精确尺寸，在 Aspose.Slides 中从头创建表格。您还将看到如何向单元格填充文本、调整对齐和边框，以及自定义表格外观。

创建 Presentation 类的实例。
通过索引获取幻灯片的引用。
定义列宽数组。
定义行高数组。
向幻灯片添加 Table。
遍历每个 Cell，并设置其上、下、右、左边框的格式。
合并前两行和前两列的单元格为一个单元格。
访问 Cell 的 TextFrame。
向 TextFrame 添加文本。
保存修改后的演示文稿。

以下 Python 示例展示如何在演示文稿中创建表格：

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

# 实例化表示演示文稿文件的 Presentation 类。
with slides.Presentation() as presentation:
    # 访问第一张幻灯片。
    slide = presentation.slides[0]

    # 定义列宽和行高。
    column_widths = [50, 50, 50]
    row_heights = [50, 30, 30, 30, 30]

    # 向幻灯片添加表格形状。
    table = slide.shapes.add_table(100, 50, column_widths, row_heights)

    # 为每个单元格设置边框格式。
    for row in table.rows:
        for cell in row:
            cell.cell_format.border_top.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_top.fill_format.solid_fill_color.color = draw.Color.red
            cell.cell_format.border_top.width = 5

            cell.cell_format.border_bottom.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_bottom.fill_format.solid_fill_color.color= draw.Color.red
            cell.cell_format.border_bottom.width = 5

            cell.cell_format.border_left.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_left.fill_format.solid_fill_color.color =draw.Color.red
            cell.cell_format.border_left.width = 5

            cell.cell_format.border_right.fill_format.fill_type = slides.FillType.SOLID
            cell.cell_format.border_right.fill_format.solid_fill_color.color = draw.Color.red
            cell.cell_format.border_right.width = 5
        
    # 合并从 (row 0, col 0) 到 (row 1, col 1) 的单元格。
    table.merge_cells(table.rows[0][0], table.rows[1][1], False)

    # 向合并的单元格添加文本。
    table.rows[0][0].text_frame.text = "Merged Cells"

    # 将演示文稿保存到磁盘。
    presentation.save("table.pptx", slides.export.SaveFormat.PPTX)

标准表格中的编号

在标准表格中，单元格编号直观且从零开始。表格中的第一个单元格索引为 (0, 0)（第 0 列，第 0 行）。

例如，在一个 4 列 4 行的表格中，单元格的编号如下：

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

以下 Python 示例展示如何使用此零基编号引用单元格：

import aspose.slides as slides

with slides.Presentation() as presentation:
    # 访问第一张幻灯片。
    slide = presentation.slides[0]

    # 添加一个包含 4 列 4 行的表格。
    table = slide.shapes.add_table(100, 50, [50, 50, 50, 50], [30, 30, 30, 30])

    for row_index in range(len(table.rows)):
        for column_index in range(len(table.rows[row_index])):
            cell = table.rows[row_index][column_index]
            cell.text_frame.text = f"({column_index}, {row_index})"

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

访问现有表格

本节说明如何使用 Aspose.Slides 在演示文稿中定位并操作现有表格。您将学习如何在幻灯片上查找表格、访问其行、列和单元格，以及更新内容或格式。

创建 Presentation 类的实例。
通过索引获取包含该表格的幻灯片的引用。
遍历所有 Shape 对象，直到找到表格。
使用 Table 对象操作表格。
保存修改后的演示文稿。

Note

如果幻灯片包含多个表格，最好通过其 alternative_text 属性搜索所需的表格。

以下 Python 示例展示如何访问并操作现有表格：

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

# 实例化 Presentation 类以加载 PPTX 文件。
with slides.Presentation("sample.pptx") as presentation:
    # 访问第一张幻灯片。
    slide = presentation.slides[0]

    table = None

    # 遍历形状并引用找到的第一个表格。
    for shape in slide.shapes:
        if isinstance(shape, slides.Table):
            table = shape
            break

    # 设置第一行第一列单元格的文本。
    if table is not None:
        table.rows[0][0].text_frame.text = "Found"

    # 将修改后的演示文稿保存到磁盘。
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

查找拥有 TextFrame 的单元格

当通用文本处理代码从表格中获取到一个 TextFrame 时，使用 TextFrame.parent_cell 属性检索其所属的 Cell。对于表格单元格的文本框，TextFrame.parent_cell 已设置且 TextFrame.parent_shape 为 None，即使表格本身也是一种形状。

单元格坐标可通过只读属性 Cell.first_column_index 和 Cell.first_row_index 获得。TextFrame.parent_cell 也是只读的：它提供指向拥有者的导航，但不改变所有权。在使用之前始终检查返回的单元格是否为 None。

有关完整示例（识别表格单元格和形状拥有者，包括与 SmartArt 节点关联的形状），请参阅 Search and Replace Text。

在表格中对齐文本

本节展示如何使用 Aspose.Slides 控制表格单元格内文本的放置。您将学习如何在单元格中垂直锚定文本并更改文本的走向。

创建 Presentation 类的实例。
通过索引获取幻灯片的引用。
向幻灯片添加 Table 对象。
从表格中获取一个 Cell 对象。
在单元格内垂直居中对齐文本并设置文本方向。
保存修改后的演示文稿。

以下 Python 示例展示如何在表格中对齐文本：

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

# 创建 Presentation 类的实例。
with slides.Presentation() as presentation:
    # 访问第一张幻灯片。
    slide = presentation.slides[0]

    # 定义列宽和行高。
    column_widths = [40, 120, 120, 120]
    row_heights = [100, 100, 100, 100]

    # 向幻灯片添加表格形状。
    table = slide.shapes.add_table(100, 50, column_widths, row_heights)
    table.rows[0][0].text_frame.text = "Numbers"
    table.rows[1][0].text_frame.text = "10"
    table.rows[2][0].text_frame.text = "20"
    table.rows[3][0].text_frame.text = "30"

    # 居中文本并设置垂直方向。
    cell = table.rows[0][0]
    cell.text_anchor_type = slides.TextAnchorType.CENTER
    cell.text_vertical_type = slides.TextVerticalType.VERTICAL270

    # 将演示文稿保存到磁盘。
    presentation.save("aligned_cell.pptx", slides.export.SaveFormat.PPTX)

在表格级别设置文本格式

本节展示如何在 Aspose.Slides 中对表格级别应用文本格式，使每个单元格继承统一的样式。您将学习如何全局设置字体大小、对齐方式和边距。

创建 Presentation 类的实例。
通过索引获取幻灯片的引用。
向幻灯片添加 Table。
为文本设置字体大小（字体高度）。
设置段落对齐方式和边距。
设置垂直文本方向。
保存修改后的演示文稿。

以下 Python 示例展示如何将首选的格式选项应用于表格中的文本：

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

# 创建 Presentation 类的实例
with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    table = slide.shapes.add_table(20, 20, [100, 50, 30], [30, 50, 30])

    # 为所有表格单元格设置字体大小。
    portion_format = slides.PortionFormat()
    portion_format.font_height = 25
    table.set_text_format(portion_format)

    # 为所有表格单元格设置右对齐文本和右边距。
    paragraph_format = slides.ParagraphFormat()
    paragraph_format.alignment = slides.TextAlignment.RIGHT
    paragraph_format.margin_right = 20
    table.set_text_format(paragraph_format)

    # 为所有表格单元格设置垂直文本方向。
    text_frame_format = slides.TextFrameFormat()
    text_frame_format.text_vertical_type = slides.TextVerticalType.VERTICAL
    table.set_text_format(text_frame_format)

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

应用内置表格样式

Aspose.Slides 允许您在代码中直接使用预定义样式格式化表格。示例演示了创建表格、应用内置样式并保存结果——这是一种确保格式一致且专业的高效方式。

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    table = slide.shapes.add_table(10, 10, [100, 150], [5, 5, 5])

    table.style_preset = slides.TableStylePreset.DARK_STYLE1

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

锁定表格的宽高比

形状的宽高比是其尺寸的比例。Aspose.Slides 提供 aspect_ratio_locked 属性，允许您锁定表格及其他形状的宽高比。

以下 Python 示例展示如何锁定表格的宽高比：

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

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    table = slide.shapes.add_table(20, 20, [100, 50, 30], [30, 50, 30])

    print(f"Lock aspect ratio set: {table.shape_lock.aspect_ratio_locked}")
    table.shape_lock.aspect_ratio_locked = not table.shape_lock.aspect_ratio_locked
    print(f"Lock aspect ratio set: {table.shape_lock.aspect_ratio_locked}")

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

常见问题

我可以为整个表格及其单元格中的文本启用从右到左 (RTL) 阅读方向吗？

可以。表格公开了 right_to_left 属性，段落则具有 ParagraphFormat.right_to_left。两者结合可确保单元格内部的 RTL 顺序和渲染正确。

如何防止用户在最终文件中移动或调整表格大小？

使用 shape locks 禁用移动、缩放、选择等。这些锁同样适用于表格。

是否支持在单元格内部插入图像作为背景？

支持。您可以为单元格设置 picture fill，图像将根据所选模式（拉伸或平铺）覆盖单元格区域。

使用 Python 管理 PowerPoint 表格中的行和列