在 PowerPoint 中管理文档属性是创建演示文稿的一个重要方面。这些属性可作为元数据，提供有关文件的重要信息，如作者、主题和关键字。通过添加、检索或删除文档属性，用户可以控制演示文稿的组织和定制。无论是添加相关标签以方便分类、访问作者详细信息，还是删除敏感数据，在 PowerPoint 中有效管理文档属性都能确保无缝协作和幻灯片演示的专业性。
在本文中，您将学习如何使用 Spire.Presentation for Python 在 Python 中添加、读取和删除 PowerPoint 文件中的文档属性。
安装 Spire.Presentation for Python
本教程需要用到 Spire.Presentation for Python 和 plum-dispatch v1.7.4。可以通过以下 pip 命令将它们轻松安装到 Windows 中。
pip install Spire.Presentation如果您不确定如何安装，请参考此教程： 如何在 Windows 中安装 Spire.Presentation for Python
预备知识
文档属性可分为两种类型：标准文档属性和自定义文档属性。
- 标准文档属性 是各种 PowerPoint 演示文稿中常用的预定义属性。标准文档属性的一些示例包括标题、作者、主题、关键字和公司。标准文档属性有助于提供有关演示文稿的一般信息和元数据。
- 自定义文档属性 是用户定义的属性，可用于在 PowerPoint 演示文稿中添加特定信息。与标准文档属性不同，自定义属性不是预定义的，可以根据具体需要进行定制。自定义属性通常提供与演示文稿相关的信息，而默认属性可能无法涵盖这些信息。
Spire.Presentation for Python 提供的 DocumentProperty 类可同时处理标准文档属性和自定义文档属性。标准文档属性可通过 DocumentProperty 类的 标题、主题、作者、经理、公司 等属性访问。要添加或检索自定义属性，可以使用 DocumentProperty 类的 set_Item() 方法和 GetPropertyName() 方法。
Python 为 PowerPoint 文件添加文档属性
要添加或更改标准文档属性，您可以为 DocumentProperty.Title 属性、DocumentProperty.Subject 属性和其他类似属性赋值。要在演示文稿中添加自定义属性，请使用 DocumentProperty.set_Item(name: str, value: SpireObject) 方法。具体步骤如下：
- 创建一个 Presentation 对象。
- 使用 Presentation.LoadFromFile() 方法加载 PowerPoint 演示文稿。
- 获取 DocumentProperty 对象。
- 通过为对象的 Title、Subject、Author、Manager、Company 和 Keywords 属性赋值，为演示文稿添加标准文档属性。
- 使用对象的 set_Item() 为演示文稿添加自定义属性。
- 使用 Presentation.SaveToFile() 方法保存演示文稿未 PPTX 文件。
- Python
from spire.presentation.common import *
from spire.presentation import *
# 创建一个新的Presentation对象
presentation = Presentation()
# 从指定的文件加载演示文稿
presentation.LoadFromFile("输入文档.pptx")
# 获取演示文稿的文档属性对象
documentProperty = presentation.DocumentProperty
# 设置演示文稿的标题
documentProperty.Title = "年度销售简报"
# 设置演示文稿的主题
documentProperty.Subject = "公司业绩和销售策略"
# 设置演示文稿的作者
documentProperty.Author = "张三"
# 设置演示文稿的经理
documentProperty.Manager = "李四"
# 设置演示文稿的公司
documentProperty.Company = "冰蓝科技公司"
# 设置演示文稿的类别
documentProperty.Category = "业务"
# 设置演示文稿的关键词
documentProperty.Keywords = "销售，战略，业绩"
# 设置演示文稿的备注
documentProperty.Comments = "请在周五之前审核并提供反馈"
# 设置自定义文档属性：文档ID
documentProperty.set_Item("文档ID", Int32(12))
# 设置自定义文档属性：授权人
documentProperty.set_Item("授权人", String("产品经理"))
# 设置自定义文档属性：授权日期
documentProperty.set_Item("授权日期", DateTime(2024, 3, 20, 0, 0, 0, 0))
# 将修改后的演示文稿保存到新文件中
presentation.SaveToFile("属性.pptx", FileFormat.Pptx2019)
presentation.Dispose()
Python 读取 PowerPoint 文件的文档属性
DocumentProperty.Title 和类似属性不仅用于设置标准属性，还可以返回标准属性的值。由于自定义属性的名称不是恒定的，我们需要使用 DocumentProperty.GetPropertyName(index: int) 方法来获取名称。然后，我们可以使用 DocumentProperty.get_Item(name: str) 方法获取属性值。
读取 PowerPoint 文件属性的步骤如下：
- 创建一个 Presentation类的对象。
- 使用 Presentation.LoadFromFile() 方法加载 PowerPoint 演示文稿。
- 获取文档属性对象。
- 使用对象的 Title、Subject、Author、Manager、Company 和 Keywords 属性获取标准文档属性。
- 获取自定义属性的计数，并遍历自定义属性。
- 使用 DocumentProperty.GetPropertyName() 方法通过索引获取特定自定义属性的名称。
- 使用 DocumentProperty.get_Item() 方法获取属性值。
- Python
from spire.presentation.common import *
from spire.presentation import *
# 创建一个新的Presentation对象
presentation = Presentation()
# 从指定文件加载演示文稿
presentation.LoadFromFile("属性.pptx")
# 获取演示文稿的文档属性对象
documentProperty = presentation.DocumentProperty
# 打印文档属性中的标题
print("标题: " + documentProperty.Title)
# 打印文档属性中的主题
print("主题：" + documentProperty.Subject)
# 打印文档属性中的作者
print("作者： " + documentProperty.Author)
# 打印文档属性中的经理
print("经理：" + documentProperty.Manager)
# 打印文档属性中的公司
print("公司： " + documentProperty.Company)
# 打印文档属性中的类别
print("类别： " + documentProperty.Category)
# 打印文档属性中的关键字
print("关键字：" + documentProperty.Keywords)
# 打印文档属性中的评论
print("评论： " + documentProperty.Comments)
# 获取自定义文档属性的数量
count = documentProperty.Count
# 遍历所有自定义文档属性
for i in range(count):
# 获取自定义文档属性的名称
customPropertyName = documentProperty.GetPropertyName(i)
# 获取自定义文档属性的值
customPropertyValue = documentProperty.get_Item(customPropertyName)
# 打印自定义文档属性的名称和值
print(customPropertyName + ": " + str(customPropertyValue))
Python 从 PowerPoint 文件中移除文档属性
删除标准属性意味着给一个属性（如 DocumentProperty.Title）赋值一个空字符串。要移除自定义属性，Spire.Presentation 提供了 DocumentProperty.Remove(name: str) 方法。以下是用 Python 从 PowerPoint 文件中移除文档属性的步骤：
- 创建一个 Presentation 类的对象。
- 使用 Presentation.LoadFromFile() 方法加载 PowerPoint 演示文稿。
- 获取 DocumentProperty 对象。
- 将对象的 Title、Subject、Author、Manager、Company 和 Keywords 属性设置为空字符串。
- 获取自定义属性的计数。
- 使用 DocumentProperty.GetPropertyName() 方法通过索引获取特定自定义属性的名称。
- 使用 DocumentProperty.Remove() 方法删除自定义属性。
- 使用 Presentation.SaveToFile() 方法将演示文稿保存为 PPTX 文件。
- Python
from spire.presentation.common import *
from spire.presentation import *
# 创建一个新的Presentation对象
presentation = Presentation()
# 从指定文件加载演示文稿
presentation.LoadFromFile("属性.pptx")
# 获取演示文稿的文档属性对象
documentProperty = presentation.DocumentProperty
# 清空默认文档属性中的内容
documentProperty.Title = ""
documentProperty.Subject = ""
documentProperty.Author = ""
documentProperty.Manager = ""
documentProperty.Company = ""
documentProperty.Category = ""
documentProperty.Keywords = ""
documentProperty.Comments = ""
# 获取自定义文档属性的数量
i = documentProperty.Count
# 逐个删除自定义文档属性
while i > 0:
# 获取自定义文档属性的名称
customPropertyName = documentProperty.GetPropertyName(i - 1)
# 移除指定名称的自定义文档属性
documentProperty.Remove(customPropertyName)
i = i - 1
# 将修改后的演示文稿保存到新文件中
presentation.SaveToFile("删除属性.pptx", FileFormat.Pptx2019)
presentation.Dispose()
申请临时 License
如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。
