本文介绍使用 PowerPoint JavaScript API 生成加载项的基础概念。
适用于 PowerPoint 的 Office.js API
PowerPoint 加载项使用 Office JavaScript API 与 PowerPoint 中的对象进行交互。 这包括两个 JavaScript 对象模型:
PowerPoint JavaScript API: PowerPoint JavaScript API 提供用于演示文稿、幻灯片、表格、形状、格式设置等的强类型对象。 若要了解 PowerPoint API 的异步性质以及它们如何使用演示文稿,请参阅 使用特定于应用程序的 API 模型。
通用 API:通用 API 允许访问多个 Office 应用程序中常见的 UI、对话框和客户端设置等功能。 要详细了解如何使用通用 API,请参阅常见 JavaScript API 对象模型。
虽然你可能会使用 PowerPoint JavaScript API 在面向 PowerPoint 的外接程序中开发大多数功能,但你还将使用通用 API 中的对象。 例如:
-
Office.Context:对象
Office.Context
表示外接程序的运行时环境,并提供对 API 的关键对象的访问。 它包含和 等contentLanguage
officeTheme
演示文稿配置详细信息,还提供有关加载项运行时环境的信息,例如host
和platform
。 此外,它还提供了requirements.isSetSupported()
方法,可用于检查运行加载项的 PowerPoint 应用程序是否支持指定的要求集。 -
Office.Document:对象
Office.Document
提供getFileAsync()
方法,可用于下载运行加载项的 PowerPoint 文件。 它还提供了getActiveViewAsync()
方法,可用于检查演示文稿是处于“读取”视图还是“编辑”视图中。 “编辑”对应于可在其中编辑幻灯片的任何视图:“普通”、“幻灯片排序器”或“大纲视图”。 “read”对应于幻灯片放映或阅读视图。
特定于 PowerPoint 的对象模型
若要了解 PowerPoint API,必须了解演示文稿的关键组件彼此之间的关系。
- 演示文稿包含幻灯片和演示文稿级实体,例如设置和自定义 XML 部件。
- 幻灯片包含形状、文本和表格等内容。
- 版式确定幻灯片内容的组织和显示方式。
有关 PowerPoint JavaScript API 支持的完整对象集,请参阅 PowerPoint JavaScript API。