在功能区上定位自定义选项卡
可以使用外接程序清单中的标记来指定外接程序的自定义选项卡在 Office 应用程序功能区上显示的位置。
注意
本文假设你熟悉 加载项命令的基本概念一文。 如果最近没有这样做，请查看它。
重要
- 本文中所述的加载项功能和标记仅在 PowerPoint web 版 中可用。
- 本文中所述的标记仅适用于支持要求集 AddinCommands 1.3 的平台。 请参阅下面的 不受支持的平台上的行为 。
默认情况下，自定义选项卡将添加到功能区的末尾。 但是，可以通过确定希望自定义选项卡旁边哪个内置 Office 选项卡，并指定它是应位于内置选项卡的左侧还是右侧，来指定要在何处显示自定义选项卡。打开加载项使用的清单类型的选项卡，了解清单标记的详细信息。
注意
Microsoft 365 的统一清单可用于生产 Outlook 加载项。它仅作为 Excel、PowerPoint 和 Word 加载项的预览版提供。
若要定位自定义选项卡，请在“extensions.ribbons.tabs”对象中包含“position”属性。 将“position.builtInTabId”属性设置为你希望自定义选项卡旁边的内置选项卡的 ID。 (请参阅 查找内置 Office 功能区选项卡的 ID。) 将“position.align”属性设置为“before” (左) 或“after” (右侧) 。
在以下示例中，自定义选项卡配置为 紧跟 在“ 审阅 ”选项卡之后。
"extensions": [
...
{
...
"ribbons": [
...
{
...
"tabs": [
{
"id": "MyTab",
...
"position": {
"builtInTabId": "TabReview",
"align": "after"
}
}
]
}
]
}
]
用户作如何影响自定义选项卡定位
- 如果用户安装多个加载项，其自定义选项卡配置为同一位置（例如，在 “审阅 ”选项卡之后），则最近安装的外接程序的选项卡将位于该位置。 以前安装的加载项的选项卡将移到一个位置。 例如，用户按该顺序安装加载项 A、B 和 C，并且所有组件都配置为在“ 审阅 ”选项卡后插入选项卡，然后选项卡将按以下顺序显示： “审阅”、“ AddinCTab”、“ AddinBTab”、“ AddinATab”。
- 用户可以在 Office 应用程序中自定义功能区。 例如，用户可以移动或隐藏加载项的选项卡。无法阻止这种情况或检测到它已发生。
- 如果用户移动其中一个内置选项卡，则 Office 会根据 内置选项卡的默认位置解释清单中的定位标记。例如，如果用户将“ 审阅 ”选项卡移动到功能区的右端，Office 会将上一个示例中的标记解释为“将自定义选项卡放在 默认 的”审阅 “选项卡的右侧。
指定文档打开时哪个选项卡具有焦点
Office 始终为紧靠在“ 文件 ”选项卡右侧的选项卡提供默认焦点。默认情况下，这是“ 开始 ”选项卡。如果将自定义选项卡配置为在 “开始 ”选项卡之前，则打开文档时，自定义选项卡将具有焦点。
重要
过分强调加载项的不便，并惹恼用户和管理员。 不要在 “开始 ”选项卡之前放置自定义选项卡，除非加载项是用户与文档交互的主要方式。
不受支持的平台上的行为
如果外接程序安装在不支持 要求集 AddinCommands 1.3 的平台上，则忽略本文中所述的标记，并且自定义选项卡将显示为功能区上最右侧的选项卡。 若要防止加载项安装在不支持标记的平台上，必须在清单中指定 AddinCommands 1.3 作为安装要求。 有关说明，请参阅 指定哪些 Office 版本和平台可以托管加载项。 或者，将外接程序设计为在不支持 AddinCommands 1.3 时提供备用体验，如 设计备用体验中所述。 例如，如果外接程序包含假设自定义选项卡位于所需位置的说明，则可以有一个备用版本，该版本假定选项卡最右侧。