如何在 Python 中向 PowerPoint 添加形状

Aspose.Slides FOSS for Python 支持向演示文稿幻灯片添加 AutoShapes、Tables、Connectors 和 PictureFrames。所有形状类型均通过 slide.shapes 集合添加。

分步指南

步骤 1：安装软件包

pip install aspose-slides-foss

验证安装：

import aspose.slides_foss as slides
print("Ready")

步骤 2：创建演示文稿

始终使用 Presentation 作为上下文管理器。

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    # ... add shapes ...
    prs.save("output.pptx", SaveFormat.PPTX)

步骤 3：添加 AutoShape

slide.shapes.add_auto_shape(shape_type, x, y, width, height) 在给定的位置和大小（均以点为单位）放置一个形状。使用 ShapeType 常量来选择形状。

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

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

    # Rectangle
    rect = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 300, 100)
    rect.add_text_frame("Rectangle shape")

    # Ellipse
    ellipse = slide.shapes.add_auto_shape(ShapeType.ELLIPSE, 400, 50, 200, 100)
    ellipse.add_text_frame("Ellipse shape")

    prs.save("autoshapes.pptx", SaveFormat.PPTX)

步骤 4：添加表格

slide.shapes.add_table(x, y, col_widths, row_heights) 在指定位置创建表格。列宽和行高是以点值为单位的列表。

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

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

    col_widths = [150.0, 150.0, 150.0]
    row_heights = [40.0, 40.0, 40.0]
    table = slide.shapes.add_table(50, 200, col_widths, row_heights)

    # Set header row text
    headers = ["Product", "Units", "Revenue"]
    for col, text in enumerate(headers):
        table.rows[0][col].text_frame.text = text

    # Set data rows
    rows = [
        ["Widget A", "120", "$2,400"],
        ["Widget B", "85", "$1,700"],
    ]
    for row_idx, row_data in enumerate(rows):
        for col, text in enumerate(row_data):
            table.rows[row_idx + 1][col].text_frame.text = text

    prs.save("table.pptx", SaveFormat.PPTX)

步骤 5：添加连接器

连接线在视觉上链接两个形状。首先创建形状，然后添加连接线并设置其起始和结束连接点。

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

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

    box1 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 100, 150, 60)
    box1.add_text_frame("Start")

    box2 = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 350, 100, 150, 60)
    box2.add_text_frame("End")

    conn = slide.shapes.add_connector(ShapeType.BENT_CONNECTOR3, 0, 0, 10, 10)
    conn.start_shape_connected_to = box1
    conn.start_shape_connection_site_index = 3  # right side of box1
    conn.end_shape_connected_to = box2
    conn.end_shape_connection_site_index = 1    # left side of box2

    prs.save("connector.pptx", SaveFormat.PPTX)

矩形的连接站点索引编号为 0–3：top=0, left=1, bottom=2, right=3.

第6步：添加图片框

将图像嵌入并将其添加到幻灯片中作为 PictureFrame。首先读取图像字节，将其添加到演示文稿的图像集合中，然后创建框架。

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    with open("logo.png", "rb") as f:
        image_data = f.read()

    image = prs.images.add_image(image_data)

    slide = prs.slides[0]
    slide.shapes.add_picture_frame(
        ShapeType.RECTANGLE,  # bounding shape type
        50, 50,               # x, y in points
        200, 150,             # width, height in points
        image
    )

    prs.save("with-image.pptx", SaveFormat.PPTX)

常见问题及解决方案

形状出现在可见幻灯片区域之外

幻灯片默认大小为 720 × 540 点。超出这些范围的 x 或 y 值会使形状位于幻灯片之外。保留 x < 720 和 y < 540，并确保 x + width <= 720 和 y + height <= 540。

AttributeError: 'NoneType' object has no attribute 'text_frame'

add_auto_shape() 直接返回形状对象。如果看到 None，请检查是否没有丢弃返回值。

表格单元格文本在赋值后为空

正确的属性是 .text_frame.text（而不是直接在单元格上使用 .text）。访问单元格使用 table.rows[row_index][col_index].text_frame.text = "value"。

常见问题

我可以在幻灯片上添加多少个形状？

没有库强加的限制。实际限制取决于文件大小以及目标 PPTX 查看器的渲染能力。

添加形状后，我可以更改其位置吗？

是的。add_auto_shape() 返回的 shape 对象具有 x、y、width 和 height 属性，您可以设置这些属性：

shape.x = 100
shape.y = 200
shape.width = 400
shape.height = 80

我可以设置形状轮廓（边框）颜色吗？

是的，通过 shape.line_format：

from aspose.slides_foss.drawing import Color
shape.line_format.fill_format.solid_fill_color.color = Color.from_argb(255, 200, 0, 0)

支持图表吗？

否。此版本未实现图表、SmartArt 和 OLE 对象，并会引发 NotImplementedError。