CustomTab 元素

为 Office 功能区定义自定义选项卡。 将加载项的功能区控件和组添加到内置的 Office 选项卡之一或您自己的自定义选项卡。使用 CustomTab> 元素向<功能区添加自定义选项卡。 在自定义选项卡上,加载项可以具有自定义组或内置组。 外接程序限定到一个自定义选项卡。

重要

在 Outlook 网页版、Mac 和 Windows 上的新 Outlook 中,<CustomTab> 元素不可用,但可以改为将自定义控件组放在内置的 OfficeTab之一上。 不能在任何平台上将 内置 组放在 Outlook 的 内置 选项卡上。

加载项类型: 任务窗格,“邮件”

仅在以下 VersionOverrides 架构中有效:

  • 任务窗格 1.0
  • 邮件 1.0
  • 邮件 1.1

有关详细信息,请参阅仅加载 项清单中的版本替代。

注意

某些子元素在邮件架构中无效。 请参阅 子元素。

与以下要求集关联:

属性

属性 必需 说明
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>