ExcelApiDesktop要求集是一个特殊要求集,其中包括仅在 Excel for Windows 和 Excel for Mac 中可用的功能。 此要求集中的 API 被视为 Windows 和 Mac 上 Excel 应用程序的生产 API。 他们遵循 Microsoft 365 开发人员支持策略。
ExcelApiDesktop API 被视为适用于其他平台(如 Web 和 iPad) )的“预览”API (,这些平台可能都不受支持。
当要求集中的 ExcelApiDesktop API 在所有平台上都受支持时,它们将添加到下一个发布的要求集中, (ExcelApi 1.[NEXT]) 。 新要求集公开后,这些 API 也将继续在此要求集中标记 ExcelApiDesktop 。 要了解有关特定于平台的一般要求的详细信息,请参阅 了解特定于平台的要求集。
重要
ExcelApiDesktop 1.1 是仅限桌面的要求集。 它是 ExcelApi 1.21 的超集。
建议的用法
由于 API 仅受 Windows 和 Mac 上的 Excel 支持,因此ExcelApiDesktop 1.1加载项应在调用这些 API 之前检查是否支持要求集。 这可避免在不受支持的平台上使用仅桌面 API 的任何尝试。
if (Office.context.requirements.isSetSupported("ExcelApiDesktop", "1.1")) {
// Any API exclusive to this ExcelApiDesktop requirement set.
}
API 处于跨平台要求集中后,应移除或编辑isSetSupported检查。 这将在其他平台上启用加载项的功能。 进行此更改时,请务必在这些平台上测试该功能。
重要
仅加载项 (XML) 清单不能将仅限桌面或仅联机的要求集指定为激活要求。 这不是在 Set 元素中使用的有效值。 统一清单支持属性中的 "requirements.capabilities" 仅桌面要求集。
API 列表
下表列出了当前包含在要求集中的 ExcelApiDesktop 1.1 Excel JavaScript API。 有关所有 Excel JavaScript API 的完整列表 (ExcelApiDesktop 1.1 包括 API 和以前发布的 API) ,请参阅 所有 Excel JavaScript API。