CustomTab 元素
定义 Office 功能区的自定义选项卡。 将加载项的功能区控件和组添加到 Office 内置选项卡之一或你自己的自定义选项卡。使用 <CustomTab> 元素将自定义选项卡添加到功能区。 在自定义选项卡上，加载项可以具有自定义组或内置组。 外接程序限定到一个自定义选项卡。
重要
在 Outlook on Mac 中， <CustomTab> 元素不可用，但你可以改为将 自定义 控件组放在内置 OfficeTab中的一个上。 不能在任何平台上将 内置 组放在 Outlook 的内置 选项卡上。
加载项类型： 任务窗格，邮件
仅在以下 VersionOverrides 架构中有效：
- 任务窗格 1.0
- 邮件 1.0
- 邮件 1.1
有关详细信息，请参阅 仅外接程序清单中的版本替代。
注意
某些子元素在邮件架构中无效。 请参阅 子元素。
与以下要求集关联：
- AddinCommands 1.1
- AddinCommands 1.3。 某些子元素需要。 请参阅 子元素。
属性
| 属性 | 必需 | 说明 |
|---|---|---|
| id | 是 | 自定义选项卡的唯一 ID。 |
id attribute
必填。 自定义选项卡的唯一标识符。它是最多 125 个字符的字符串。 这在清单中必须是唯一的。
子元素
| 元素 | 必需 | 说明 |
|---|---|---|
| Group | 否 | 定义一组命令。 |
| OfficeGroup | 否 | 表示内置 Office 控件组。 重要提示：在 Outlook 中不可用。 |
| Label | 是 | CustomTab 的标签。 |
| InsertAfter | 否 | 指定自定义选项卡应紧跟在指定的内置 Office 选项卡之后。 重要提示：仅在 PowerPoint 中可用。 |
| InsertBefore | 否 | 指定自定义选项卡应紧靠在指定的内置 Office 选项卡之前。 重要提示：仅在 PowerPoint 中可用。 |
组
可选，但如果不存在，则必须至少有一个 <OfficeGroup> 元素。 查看 Group 元素。 清单中 Group> 和 OfficeGroup 的顺序<应是你希望它们在自定义选项卡上的显示顺序。><如果有多个元素，则它们可以混用，但所有元素都必须位于 Label> 元素上方<。
OfficeGroup
可选，但如果不存在，则必须至少有一个 <Group> 元素。 表示内置 Office 控件组。 id 属性指定内置 Office 组的 ID。 若要查找内置组的 ID，请参阅 查找控件和控件组的 ID。 清单中 Group> 和 OfficeGroup 的顺序<应是你希望它们在自定义选项卡上的显示顺序。><如果有多个元素，则它们可以混用，但所有元素都必须位于 Label> 元素上方<。
重要
<OfficeGroup> 元素在 Outlook 中不可用。 在 PowerPoint 中，它在 Mac 和 Windows 中处于预览状态;但可用于 PowerPoint 网页版中的生产加载项。
外接程序类型： 任务窗格
仅在以下 VersionOverrides 架构中有效：
- 任务窗格 1.0
有关详细信息，请参阅 仅外接程序清单中的版本替代。
与以下要求集关联：
标签（选项卡）
必填。 自定义选项卡的标签。resid 属性不能超过 32 个字符，并且必须设置为 Resources 元素中 ShortStrings> 元素中<String> 元素的 id< 属性的值。
加载项类型： 任务窗格，邮件
仅在以下 VersionOverrides 架构中有效：
- 任务窗格 1.0
- 邮件 1.0
- 邮件 1.1
有关详细信息，请参阅 仅外接程序清单中的版本替代。
与以下要求集关联：
InsertAfter
可选。 指定自定义选项卡应紧跟在指定的内置 Office 选项卡之后。元素的值是内置选项卡的 ID，例如 TabHome 或 TabReview。 有关内置选项卡的列表，请参阅 OfficeTab。 如果存在，则必须在 <Label> 元素之后。 不能同时 <具有 InsertAfter> 和 <InsertBefore>。
重要
<InsertAfter> 元素仅在 PowerPoint 中可用。
外接程序类型： 任务窗格
仅在以下 VersionOverrides 架构中有效：
- 任务窗格 1.0
有关详细信息，请参阅 仅外接程序清单中的版本替代。
与以下要求集关联：
InsertBefore
可选。 指定自定义选项卡应紧接在指定的内置 Office 选项卡之前。元素的值是内置选项卡的 ID，例如 TabHome 或 TabReview。 元素的值是内置选项卡的 ID，例如 TabHome 或 TabReview。 有关内置选项卡的列表，请参阅 OfficeTab。 如果存在，则必须在 <Label> 元素之后。 不能同时 <具有 InsertAfter> 和 <InsertBefore>。
重要
<InsertBefore> 元素仅在 PowerPoint 中可用。
外接程序类型： 任务窗格
仅在以下 VersionOverrides 架构中有效：
- 任务窗格 1.0
有关详细信息，请参阅 仅外接程序清单中的版本替代。
与以下要求集关联：
示例
下面的标记示例将 Office Paragraph 控件组添加到自定义选项卡，并将其置于显示在自定义组之后。
<ExtensionPoint xsi:type="ContosoRibbonTab">
<CustomTab id="Contoso.TabCustom">
<Group id="Contoso.TabCustom1.group1">
<!-- additional markup omitted -->
</Group>
<OfficeGroup id="Paragraph" />
<Label resid="customTabLabel1" />
</CustomTab>
</ExtensionPoint>
下面的标记示例将 Office 上标控件添加到自定义组，并将其定位为显示在自定义按钮之后。
<ExtensionPoint xsi:type="ContosoRibbonTab">
<CustomTab id="Contoso.TabCustom">
<Group id="Contoso.TabCustom2.group2">
<Label resid="residCustomTabGroupLabel"/>
<Icon>
<bt:Image size="16" resid="blue-icon-16" />
<bt:Image size="32" resid="blue-icon-32" />
<bt:Image size="80" resid="blue-icon-80" />
</Icon>
<Control xsi:type="Button" id="Contoso.Button2">
<!-- information on the control omitted -->
</Control>
<OfficeControl id="Superscript" />
<!-- other controls, as needed -->
</Group>
<Label resid="customTabLabel1" />
</CustomTab>
</ExtensionPoint>