如何在任务窗格加载项中使用 Office.Startup Behavior.load？

Question

根据the docs，可以设置代码一打开文档就运行：

您可以将 Office 加载项配置为在文档打开后立即加载和运行代码。如果您需要在加载项可见​​之前注册事件处理程序、为任务窗格预加载数据、同步 UI 或执行其他任务，这将非常有用。

以下代码将您的外接程序配置为在文档打开时加载并开始运行。

Office.addin.setStartupBehavior(Office.StartupBehavior.load);

这正是我打算做的：在用户打开任务窗格之前根据文档内容语言为加载项加载翻译，以减少加载时间。

但是，文档并没有明确说明上述代码的放置位置。是在taskpane.js 上吗（或者我的代码的入口点在 taskpane.html 中）？

此外，文档指出方法 setStartupBehavior 是异步的。等待它的解决与任何事情有关吗？

最后，这个方法调用显然依赖于Office 全局。我必须在初始化后放置（Office.onReady/Office.initialize）还是立即允许？

Answer 1

有关如何使用 API 的示例，请参阅此示例：excel-shared-runtime-scenario。

在Office.onReady/Office.initialize之前不能调用，但是可以在里面调用。但是，直到下次打开文档时才会出现效果，并且每次打开文档时都不需要调用它。一旦使用load 参数调用它，那么代码将在文档打开时运行，除非/直到它被（重新）调用none。

由于该功能直到下次打开文档时才会生效，所以我认为等待它没有任何意义。