为 Office 功能区定义自定义选项卡。 将加载项的功能区控件和组添加到内置的 Office 选项卡之一或您自己的自定义选项卡。使用 CustomTab> 元素向<功能区添加自定义选项卡。 在自定义选项卡上,加载项可以具有自定义组或内置组。 外接程序限定到一个自定义选项卡。
重要
在 Outlook 网页版、Mac 和 Windows 上的新 Outlook 中,<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 元素。 清单中组>和 OfficeGroup 的<顺序应是希望它们显示在自定义选项卡上的顺序。><如果有多个元素,则可以混合使用它们,但所有元素都必须位于 Label> 元素上方<。
OfficeGroup
可选,但如果不存在,则必须至少 <有一个组> 元素。 表示内置的 Office 控制组。 ID 属性指定内置 Office 组的 ID。 要查找内置组的 ID,请参阅 查找控件和控件组的 ID。 清单中组>和 OfficeGroup 的<顺序应是希望它们显示在自定义选项卡上的顺序。><如果有多个元素,则可以混合使用它们,但所有元素都必须位于 Label> 元素上方<。
重要
<Office 组>元素在 Outlook 中不可用。 在 PowerPoint 中,它为 Mac 和 Windows 提供预览版;但适用于 PowerPoint Web 版中的生产加载项。
外接程序类型: 任务窗格
仅在以下 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 段落”控件组添加到自定义选项卡,并将其定位为紧靠在自定义组之后显示。
<ExtensionPoint xsi:type="PrimaryCommandSurface">
<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="PrimaryCommandSurface">
<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>