要求WordApiDesktop集是一个特殊要求集,包括仅在 Windows 和 Mac 上可用于Word的功能。 此要求集中的 API 被视为 Windows 和 Mac 上的 Word 应用程序的生产 API。 它们遵循 Microsoft 365 开发人员支持策略。
WordApiDesktop API 被视为其他平台的“预览”API, (例如 Web) ,并且可能不受其中任何平台的支持。
当所有平台都支持要求集中的 WordApiDesktop API 时,它们将添加到下一个发布的要求集 (WordApi 1.[NEXT]) 。 新要求集公开后,这些 API 将继续在此 WordApiDesktop 要求集中标记。 若要了解有关平台特定要求的详细信息,请参阅 了解特定于平台的要求集。
重要
WordApiDesktop 1.5 是仅限桌面的要求集。 它是 WordApiDesktop 1.4 的超集。
建议的用法
WordApiDesktop 1.5由于只有 Windows 和 Mac 上的 Word支持 API,因此,如果在调用这些 API 之前支持要求集,则外接程序应检查。 这可避免在不支持的平台上尝试使用仅限桌面的 API。
if (Office.context.requirements.isSetSupported("WordApiDesktop", "1.5")) {
// Any API exclusive to this WordApiDesktop requirement set.
}
API 进入跨平台要求集后,应删除或编辑isSetSupported检查。 这将在其他平台上启用加载项的功能。 进行此更改时,请务必在这些平台上测试该功能。
重要
清单不能指定 WordApiDesktop 1.5 为激活要求。 它不是 在 Set 元素中使用的有效值。
API 列表
下表列出了要求集中当前包含WordApiDesktop 1.5Word JavaScript API。 有关所有Word JavaScript API 的完整列表, (包括 WordApiDesktop 1.5 API 和以前发布的 API) ,请参阅所有Word JavaScript API。
| 类 | 域 | 说明 |
|---|---|---|
| ListTemplateAddOptions | 名称 | 如果提供,则指定要添加的列表模板的名称。 |
| outlineNumbered | 如果已提供,则指定是否对新列表模板应用大纲编号。 | |
| ListTemplateCollection | 添加 (选项?:Word。ListTemplateAddOptions) |
ListTemplate添加新对象。 |