在 Outlook 中创建自定义加载项时是否有办法让加载项在激活时始终在侧面板中可见

Question

我一直在尝试创建自己的自定义插件，但是当在列表中的电子邮件之间切换时，插件消失并且必须再次打开。

从文档中我发现清单xml中有两个设置，一个是扩展点的消息messageReadCommandSurface，另一个是messageComposeCommandSurface，它允许插件出现，但我希望它在阅读电子邮件时出现，但是当打开并单击另一封电子邮件时，插件是关闭。无论如何，是否有办法使其在打开后始终可见，直到用户决定关闭它为止？

https://learn.microsoft.com/en-us/javascript/api/manifest/extensionpoint?view=common-js-preview#primarycommandsurface

Answer 1

您能做的最好的事情就是实现

pinnable task pane

，这样用户就可以固定它，并且在电子邮件之间切换时任务窗格将保持可见，并且您的代码可以以编程方式处理项目切换。

默认情况下，如果用户为

Reading Pane

中的消息打开了加载项任务窗格，然后选择了新消息，则任务窗格将自动关闭。对于频繁使用的加载项，用户可能更愿意保持该窗格打开，从而无需在每条消息上重新激活加载项。通过可固定的任务窗格，您的加载项可以为用户提供该选项。

第一步是添加固定支持，这是在加载项清单中完成的。将

SupportsPinning

元素添加到描述任务窗格按钮的元素中。例如：

<!-- Task pane button -->
<Control xsi:type="Button" id="msgReadOpenPaneButton">
  <Label resid="paneReadButtonLabel" />
  <Supertip>
    <Title resid="paneReadSuperTipTitle" />
    <Description resid="paneReadSuperTipDescription" />
  </Supertip>
  <Icon>
    <bt:Image size="16" resid="green-icon-16" />
    <bt:Image size="32" resid="green-icon-32" />
    <bt:Image size="80" resid="green-icon-80" />
  </Icon>
  <Action xsi:type="ShowTaskpane">
    <SourceLocation resid="readTaskPaneUrl" />
    <SupportsPinning>true</SupportsPinning>
  </Action>
</Control>

<SupportsPinning>

元素是在

VersionOverrides v1.1

模式中定义的，因此您需要为

VersionOverrides

和

v1.0

包含一个

v1.1

元素。有关完整示例，请参阅

command-demo 示例清单

中的 msgReadOpenPaneButton 控件。

有关详细信息，请参阅在 Outlook 中实现可固定任务窗格。