CustomTab 元素

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

重要

在 Outlook on Mac 中, <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 元素清单中 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,例如 TabHomeTabReview。 有关内置选项卡的列表,请参阅 OfficeTab。 如果存在,则必须在 <Label> 元素之后。 不能同时 <具有 InsertAfter><InsertBefore>

重要

<InsertAfter> 元素仅在 PowerPoint 中可用。

外接程序类型: 任务窗格

仅在以下 VersionOverrides 架构中有效

  • 任务窗格 1.0

有关详细信息,请参阅 仅外接程序清单中的版本替代

与以下要求集关联

InsertBefore

可选。 指定自定义选项卡应紧接在指定的内置 Office 选项卡之前。元素的值是内置选项卡的 ID,例如 TabHomeTabReview。 元素的值是内置选项卡的 ID,例如 TabHomeTabReview。 有关内置选项卡的列表,请参阅 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>