使用 Python 管理演示文稿中的表格单元格

概述

Aspose.Slides 允许您在 PowerPoint 演示文稿中访问和修改表格单元格。本文说明如何识别合并的表格单元格、删除单元格边框、在合并或拆分单元格后处理单元格编号、更改单元格的背景颜色以及在表格单元格内添加图像。示例展示了如何创建或打开演示文稿、从幻灯片获取表格、通过单元格属性更新单元格格式,并将修改后的演示文稿保存为 PPTX 文件。
Aspose.Slides 使用从零开始的索引以 (列, 行) 的顺序访问表格单元格。

识别合并的表格单元格

示例打开一个现有的演示文稿,并将第一页幻灯片上的第一个形状作为表格访问。它假设幻灯片和形状存在且该形状是表格。然后遍历所有行和列,并使用 isMergedCell 来识别合并区域中的单元格。对于每个匹配项,打印以 row;column 顺序的单元格坐标、getRowSpan、getColSpan 以及区域的起始坐标,getFirstRowIndex 和 getFirstColumnIndex。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("presentation_with_table.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    table = slide.getShapes().get_Item(0)

    row_count = table.getRows().size()
    for row_index in range(row_count):
        column_count = table.getColumns().size()
        for column_index in range(column_count):
            cell = table.get_Item(column_index, row_index)
            if cell.isMergedCell():
                print(f"Cell {row_index};{column_index} belongs to a merged region with RowSpan={cell.getRowSpan()} and ColSpan={cell.getColSpan()} starting at {cell.getFirstRowIndex()};{cell.getFirstColumnIndex()}.")
finally:
    presentation.dispose()

删除表格单元格边框

创建一个 Presentation 并使用 addTable 在其第一页幻灯片上添加表格。列宽、行高和表格位置以点为单位指定。示例将四个单元格边框全部设置为 FillType.NoFill,使其不可见。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, FillType, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    column_widths = [50, 50, 50, 50]
    row_heights = [50, 30, 30, 30, 30]
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    for row in table.getRows():
        for cell in row:
            cell.getCellFormat().getBorderTop().getFillFormat().setFillType(FillType.NoFill)
            cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(FillType.NoFill)
            cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(FillType.NoFill)
            cell.getCellFormat().getBorderRight().getFillFormat().setFillType(FillType.NoFill)

    presentation.save("table.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

添加对角线单元格边框

使用 getBorderDiagonalDown 绘制从左上角到右下角的线,使用 getBorderDiagonalUp 绘制从左下角到右上角的线。对角线可以标记角落标题。两条对角线可以形成 X,以标记单元格不适用。
每条对角线都是一个 LineFormat。在其 getFillFormat 中,使用 setFillType 选择 FillType.Solid 并通过 getSolidFillColor 选择颜色。使用 setWidth 以点设置线宽。
示例在同一行创建了三个单元格:一个红色向下对角线、一个蓝色向上对角线,以及两条对角线。它保持上、下、左、右单元格边框不变。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, FillType, SaveFormat
from java.awt import Color


def format_border(border, color, width):
    fill = border.getFillFormat()
    fill.setFillType(FillType.Solid)
    fill.getSolidFillColor().setColor(color)
    border.setWidth(width)


presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    table = slide.getShapes().addTable(45, 130, [210, 210, 210], [160])

    left_cell = table.get_Item(0, 0).getCellFormat()
    middle_cell = table.get_Item(1, 0).getCellFormat()
    right_cell = table.get_Item(2, 0).getCellFormat()
    format_border(left_cell.getBorderDiagonalDown(), Color.RED, 3)
    format_border(middle_cell.getBorderDiagonalUp(), Color.BLUE, 5)
    format_border(right_cell.getBorderDiagonalDown(), Color.RED, 3)
    format_border(right_cell.getBorderDiagonalUp(), Color.BLUE, 5)

    presentation.save("diagonal_cell_borders.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

对角线是一种格式属性,而不是单元格拆分。每个单元格保留一个文本框,可通过 getTextFrame 访问。对角线两侧的区域不能独立编辑。
保存的表格,在 Microsoft PowerPoint 中渲染如下: 三个表格单元格,显示左上到右下的红色对角线、左下到右上的蓝色对角线以及形成 X 的两条对角线。

从左到右:向下对角线(红色,3 pt),向上对角线(蓝色,5 pt),以及两条对角线。

合并表格单元格

使用 mergeCells 将矩形范围的表格单元格合并为一个单元格。指定范围左上角和右下角的单元格。最后一个参数控制合并是否可以包含范围外的单元格;False 将合并限制在该范围内。
示例创建了一个 4×4 的表格,列宽和行高为 70 点,然后合并 (1, 1) 到 (2, 2) 的四个中心单元格。结果单元格跨越两列两行,而表格的底层网格仍保留四列四行。要访问合并单元格的内容或格式,请使用其左上位置:本例中为 table.get_Item(1, 1)。合并范围内的其他位置仍是表格网格的一部分,因此范围外单元格的索引保持不变。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    column_widths = [70, 70, 70, 70]
    row_heights = [70, 70, 70, 70]
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    table.mergeCells(table.get_Item(1, 1), table.get_Item(2, 2), False)

    presentation.save("merged_cells.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

拆分表格单元格

前面示例中的单元格合并保持了表格的网格。拆分单元格可能会引入新的网格列并改变其右侧单元格的列索引。Aspose.Slides 遵循 PowerPoint 的表格网格模型。
本例创建了一个 4×4 的表格,列宽和行高为 70 点,并对单元格 (1, 1) 调用 splitByWidth。将单元格 70 点宽度的一半传入,以创建两个等宽单元格。
拆分后,这两半分别通过 table.get_Item(1, 1) 和 table.get_Item(2, 1) 访问。表格网格现在有五列:原本位于第 2 列和第 3 列的单元格分别移动到第 3 列和第 4 列。行索引保持不变。拆分后访问单元格时请使用这些更新后的列索引。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    column_widths = [70, 70, 70, 70]
    row_heights = [70, 70, 70, 70]
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    table.get_Item(1, 1).splitByWidth(table.get_Item(1, 1).getWidth() / 2)

    presentation.save("split_cells.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

一个未合并的 70 点单元格拆分为两个 35 点单元格,添加第五列网格并将右侧的索引向右移动。

宽度拆分影响单元格 (1, 1),使用从零开始的 (列, 行) 索引。其他行保持单元格跨越两个新列位置。

按行或列跨度拆分合并的单元格

为了准备合并的模板单元格用于填充数据,可使用 splitByRowSpan 按现有行边界拆分,或使用 splitByColSpan 按列边界拆分。
index 参数计算拆分上部的行数或左部的列数;它相对于合并区域:

  • 行拆分:0 < index < getRowSpan.
  • 列拆分:0 < index < getColSpan.
    示例假设演示文稿的第一张幻灯片的第一个形状是表格,并且 (1, 2) 和 (1, 3) 垂直合并。从下方位置开始,它使用 getFirstColumnIndex 和 getFirstRowIndex 定位起点并检查两个跨度。随后 splitByRowSpan(1) 将第 2 行和第 3 行分离用于产品名称。对于水平的两列合并,请改用 splitByColSpan(1)。
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("table_template.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    table = slide.getShapes().get_Item(0)

    selected_cell = table.get_Item(1, 3)
    first_column_index = selected_cell.getFirstColumnIndex()
    first_row_index = selected_cell.getFirstRowIndex()
    merged_cell = table.get_Item(first_column_index, first_row_index)

    if merged_cell.isMergedCell() and merged_cell.getRowSpan() == 2 and merged_cell.getColSpan() == 1:
        merged_cell.splitByRowSpan(1)

        # 检索拆分后表格中产生的单元格。
        upper_cell = table.get_Item(first_column_index, first_row_index)
        lower_cell = table.get_Item(first_column_index, first_row_index + 1)
        print(f"Upper cell merged: {upper_cell.isMergedCell()}")
        print(f"Lower cell merged: {lower_cell.isMergedCell()}")

        upper_cell.getTextFrame().setText("Product A")
        lower_cell.getTextFrame().setText("Product B")

        presentation.save("split_template.pptx", SaveFormat.Pptx)
    else:
        print("Select a merged region spanning exactly two rows and one column.")
finally:
    presentation.dispose()

表格网格和周围单元格的索引保持不变。通过坐标检索得到的单元格;此处两者的跨度均为 1,且 isMergedCell 打印 False。更大的区域在一次拆分后仍可能部分保留合并状态。
原始文本及其格式保留在上部(或左部)单元格;新单元格为空,但继承了填充、边框和边距等单元格格式。拆分后填充单元格并显式设置所需的文本格式。
保存的演示文稿包含单独的 “Product A” 和 “Product B” 单元格,保留了模板的单元格格式。详见 Cell API Reference。

在特定高度拆分单元格

splitByHeight 以点为单位指定上部的高度。splitByRowSpan 以上部现有网格行数指定。要在右侧列中居中一个 40 点的单元格,需要先从单元格的实际高度中减去 40,然后将剩余空间在上方和下方平均分配。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat
presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    table = slide.getShapes().addTable(50, 50, [160, 160], [140])
    table.get_Item(0, 0).getTextFrame().setText("Left")

    height = table.get_Item(1, 0).getHeight()
    margin = (height - 40) / 2
    
    table.get_Item(1, 0).splitByHeight(margin)
    table.get_Item(1, 1).splitByHeight(40)
    table.get_Item(1, 1).getTextFrame().setText("Middle")

    presentation.save("split_by_height.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

第一次拆分添加了一行网格,并在单元格 (1, 1) 留下下部 90 点。第二次拆分将该单元格分为一个 40 点的中间单元格和一个 50 点的底部单元格。右侧列现在有三个单元格,从上到下的高度分别为 50、40 和 50 点。左侧单元格跨越所有三行,保持原始高度 140 点。
左侧单元格跨越整个表格高度,旁边有三个单元格,中间为 Middle。

更改表格单元格背景颜色

本例创建了一个列宽 150 点、行高 50 点的表格。它使用 setFillType 选择实心填充,并将 getSolidFillColor 返回的颜色设置为红色,作用于第 3 列第 4 行的单元格 (2, 3)。

import jpase
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, FillType, SaveFormat
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    column_widths = [150, 150, 150, 150]
    row_heights = [50, 50, 50, 50, 50]
    table = slide.getShapes().addTable(50, 50, column_widths, row_heights)

    cell = table.get_Item(2, 3)
    cell.getCellFormat().getFillFormat().setFillType(FillType.Solid)
    cell.getCellFormat().getFillFormat().getSolidFillColor().setColor(Color.RED)

    presentation.save("cell_background_color.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

在表格单元格内添加图像

在运行本示例之前,请将输入图像放置在工作目录中。它使用 Images.fromFile 加载图像,并通过 addImage 将其添加到演示文稿的图像集合中。随后将该图像分配给单元格 (0, 0)(表格中的第一个单元格)的图片填充。
PictureFillMode.Stretch 将图像拉伸以填充单元格,可能会改变其宽高比。列宽和行高以点为单位。加载的图像在添加到演示文稿后于 finally 块中被释放。

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, Images, FillType, PictureFillMode, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    column_widths = [150, 150, 150, 150]
    row_heights = [100, 100, 100, 100, 90]
    table = slide.getShapes().addTable(50, 50, column_widths, row_heights)

    image = Images.fromFile("aspose_logo.jpg")
    try:
        presentation_image = presentation.getImages().addImage(image)
    finally:
        image.dispose()

    table.get_Item(0, 0).getCellFormat().getFillFormat().setFillType(FillType.Picture)
    table.get_Item(0, 0).getCellFormat().getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch)
    table.get_Item(0, 0).getCellFormat().getFillFormat().getPictureFillFormat().getPicture().setImage(presentation_image)

    presentation.save("table_cell_with_image.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

常见问题

我可以为单个单元格的不同边设置不同的线宽和样式吗?
可以。单元格的 top/bottom/left/right 边框各自拥有独立的属性,因此每一侧的线宽和样式可以不同。

在将图片设置为单元格背景后,如果我更改列/行尺寸,会发生什么?
行为取决于 fill mode。使用 stretch 时,图像会适应新的单元格;使用 tile 时,平铺会重新计算。

我可以为单元格的全部内容分配超链接吗?
Hyperlinks 在单元格的文本框内的文本(段落)级别或整个表格/形状级别设置。实际上,您可以将链接分配给某段文字或单元格中的全部文本。

我可以在单个单元格内设置不同的字体吗?
可以。单元格的文本框支持 portions(文本段)拥有独立的格式——字体、样式、大小和颜色。