开发者指南

本指南涵盖了 Aspose.Slides FOSS for Python 的核心功能，并为每个特性区域提供可运行的代码示例。.

本节内容

页面描述
功能与能力支持的功能完整列表：幻灯片、形状、文本、填充、效果、3D 格式、备注、评论、图像和文档属性。.
图像处理将图像以图片框的形式嵌入幻灯片，可来源于文件或字节流；控制填充模式（拉伸、平铺）。.
连接线处理在形状之间添加弯曲、折角和直线连接器；设置连接点和线条样式。.
3D 效果处理为形状应用外部阴影、发光、模糊、斜角、相机预设、灯光装置和材质。.
评论处理添加线程式审阅评论和演讲者备注；管理评论作者；读取批注。.

API 入口点

每个操作都以一个 Presentation 对象开始。始终将其用作上下文管理器：:

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

# Open existing
with slides.Presentation("input.pptx") as prs:
    # work with prs
    prs.save("output.pptx", SaveFormat.PPTX)

# Create new
with slides.Presentation() as prs:
    # work with prs
    prs.save("new.pptx", SaveFormat.PPTX)

上下文管理器确保在代码块退出时释放内部 COM/XML 资源。不要存储一个 Presentation 在…之外的引用 with 块。.

支持的输出格式

唯一支持的保存格式是 PPTX (SaveFormat.PPTX). 导出为 PDF、HTML、SVG 或图像格式在此版本中不可用。.

关键类

类 / 枚举导入路径描述
Presentationaspose.slides_foss根容器；用作上下文管理器
ShapeTypeaspose.slides_foss形状类型枚举（RECTANGLE，ELLIPSE，…）
FillTypeaspose.slides_foss填充类型枚举（SOLID，GRADIENT，…）
NullableBoolaspose.slides_foss格式化的三态布尔值（TRUE，FALSE，NOT_DEFINED）
SaveFormataspose.slides_foss.export输出格式枚举（仅支持 PPTX）
Coloraspose.slides_foss.drawingARGB 颜色构造函数
PointFaspose.slides_foss.drawing浮点二维点（用于评论位置）

已知限制

以下区域会引发 NotImplementedError 在此版本中：:

  • 图表:：不支持图表创建或修改
  • SmartArt:：不受支持
  • 动画和过渡:：无法设置幻灯片过渡和对象动画
  • 导出格式: 仅支持 PPTX 保存；不支持 PDF、HTML、SVG 或图像导出
  • 超链接和操作设置: 链接对象不可修改
  • VBA 宏和数字签名: 不可访问

在加载期间遇到的未知 XML 部分在保存时会原样保留，因此往返转换永远不会删除库尚未理解的内容。.

另请参阅

 中文