javascript - microsoft office javascript API中messageRead和messageWrite模式的逻辑？

Question

目前正在开发基于 JavaScript 的 Outlook 插件。当加载项启动时，我想在读取和写入模式下打开不同的对话框。

如何检查加载项是否处于消息读取或写入模式？

ma​​nifest.xml

<!-- Message Read -->
    <ExtensionPoint xsi:type="MessageReadCommandSurface">
    <!-- Use the default tab of the ExtensionPoint or create your own with <CustomTab id="myTab"> -->
    <OfficeTab id="TabDefault">
        <!-- Up to 6 Groups added per Tab -->
        <Group id="msgReadGroup">
        <Label resid="groupLabel" />
        <!-- Launch the add-in : 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="icon16" />
            <bt:Image size="32" resid="icon32" />
            <bt:Image size="80" resid="icon80" />
            </Icon>
            <Action xsi:type="ShowTaskpane">
            <SourceLocation resid="messageReadTaskPaneUrl" />
            </Action>
        </Control>
        </Group>
    </OfficeTab>
    </ExtensionPoint>


<!-- Message Compose -->
    <ExtensionPoint xsi:type="MessageComposeCommandSurface">
        <OfficeTab id="TabDefault">
            <Group id="msgComposeCmdGroup">
            <Label resid="groupLabel"/>
            <Control xsi:type="Button" id="msgComposeIndex">
                <Label resid="indexLabel"/>
                <Supertip>
                <Title resid="indexTitle"/>
                <Description resid="insertGistDesc"/>
                </Supertip>
                <Icon>
                <bt:Image size="16" resid="icon16"/>
                <bt:Image size="32" resid="icon32"/>
                <bt:Image size="80" resid="icon80"/>
                <bt:Image size="80" resid="paksign"/>

                </Icon>
                <Action xsi:type="ShowTaskpane">
                <SourceLocation resid="index-file" />
                </Action>
            </Control>
            </Group>
        </OfficeTab>
    </ExtensionPoint>

Answer 1

我们建议使用不同的 SourceLocation URL，或向 URL 添加查询参数，以区分不同的模式(即 ...index.html?mode=MessageRead)。

在您的示例 list 中，这意味着对 messageReadTaskPaneUrl 和 index-file URL 使用不同的 URL 或查询参数。

虽然可以检查是否定义了 API 来尝试确定模式，但我们不建议这样做，因为将来可能会添加 API。例如，Office.context.mailbox.item.from 最初仅在 API 要求集 1.0 中以读取模式定义(在撰写模式中未定义)。但当 Office.context.mailbox.item.from.getAsync 添加到 requirement set 1.7 中的撰写模式时，情况发生了变化。 .