在功能区上定位自定义选项卡

可以使用外接程序清单中的标记来指定外接程序的自定义选项卡在 Office 应用程序功能区上显示的位置。

注意

本文假设你熟悉 加载项命令的基本概念一文。 如果最近没有这样做，请查看它。

重要

• 本文中所述的加载项功能和标记仅在 PowerPoint web 版 中可用。
• 本文中所述的标记仅适用于支持要求集 AddinCommands 1.3 的平台。 请参阅下面的 不受支持的平台上的行为 。

通过确定要在自定义选项卡旁边显示哪个内置 Office 选项卡，并指定它是应位于内置选项卡的左侧还是右侧，来指定希望自定义选项卡的显示位置。通过在外接程序清单的 CustomTab 元素中包括 InsertBefore (左侧) 或 InsertAfter (右侧) 元素来制定这些规范。 (不能同时具有元素。)

在以下示例中，自定义选项卡配置为紧跟在“审阅”选项卡之后。请注意，InsertAfter> 元素的值<是内置 Office 选项卡的 ID。

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom2">
    <Group id="Contoso.TabCustom2.group2">
       <!-- additional markup omitted -->
    </Group>
    <Label resid="customTabLabel1" />
    <InsertAfter>TabReview</InsertAfter>
  </CustomTab>
</ExtensionPoint>

请记住以下几点。

• <InsertBefore> 和 <InsertAfter> 元素是可选的。 如果两者均未使用，则自定义选项卡将显示为功能区上最右侧的选项卡。
• <InsertBefore> 和 <InsertAfter> 元素是互斥的。 不能同时使用这两者。
• 如果用户安装多个加载项，其自定义选项卡配置为同一位置（例如，在 “审阅 ”选项卡之后），则最近安装的外接程序的选项卡将位于该位置。 以前安装的加载项的选项卡将移到一个位置。 例如，用户按该顺序安装加载项 A、B 和 C，并且所有组件都配置为在“ 审阅 ”选项卡后插入选项卡，然后选项卡将按以下顺序显示： “审阅”、“ AddinCTab”、“ AddinBTab”、“ AddinATab”。
• 用户可以在 Office 应用程序中自定义功能区。 例如，用户可以移动或隐藏加载项的选项卡。无法阻止这种情况或检测到它已发生。
• 如果用户移动其中一个内置选项卡，则 Office 会<根据内置选项卡的默认位置解释 InsertBefore> 和 <InsertAfter> 元素。例如，如果用户将“审阅”选项卡移动到功能区的右端，Office 会将上一个示例中的标记解释为“将自定义选项卡放在默认的”审阅“选项卡的右侧。

指定文档打开时哪个选项卡具有焦点

Office 始终为紧靠在“ 文件 ”选项卡右侧的选项卡提供默认焦点。默认情况下，这是“ 开始 ”选项卡。如果将自定义选项卡配置为在 “开始 ”选项卡之前，使用 <InsertBefore>TabHome</InsertBefore>，则文档打开时，自定义选项卡将具有焦点。

重要

过分强调加载项的不便，并惹恼用户和管理员。 不要在 “开始 ”选项卡之前放置自定义选项卡，除非加载项是用户与文档交互的主要方式。

不受支持的平台上的行为

如果外接程序安装在不支持 要求集 AddinCommands 1.3 的平台上，则忽略本文中所述的标记，并且自定义选项卡将显示为功能区上最右侧的选项卡。 若要防止加载项安装在不支持标记的平台上，请在清单的“要求>”部分中添加对要求集<的引用。 有关说明，请参阅 指定哪些 Office 版本和平台可以托管加载项。 或者，将外接程序设计为在不支持 AddinCommands 1.3 时提供备用体验，如 设计备用体验中所述。 例如，如果外接程序包含假设自定义选项卡位于所需位置的说明，则可以有一个备用版本，该版本假定选项卡最右侧。