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 中可用。

Group

可选，但如果不存在，则必须至少有一个 <OfficeGroup> 元素。 查看 Group 元素。 清单中 Group> 和 OfficeGroup 的顺序<应是你希望它们在自定义选项卡上的显示顺序。><如果有多个元素，则它们可以混用，但所有元素都必须位于 Label> 元素上方<。

OfficeGroup

可选，但如果不存在，则必须至少有一个 <Group> 元素。 表示内置 Office 控件组。 id 属性指定内置 Office 组的 ID。 若要查找内置组的 ID，请参阅 查找控件和控件组的 ID。 清单中 Group> 和 OfficeGroup 的顺序<应是你希望它们在自定义选项卡上的显示顺序。><如果有多个元素，则它们可以混用，但所有元素都必须位于 Label> 元素上方<。

重要

<OfficeGroup> 元素在 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 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>