Group 元素

在选项卡中定义一组 UI 控件。在自定义选项卡上，加载项可以创建多个组。 外接程序限定到一个自定义选项卡。

加载项类型： 任务窗格，邮件

仅在以下 VersionOverrides 架构中有效：

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

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

与以下要求集关联：

• AddinCommands 1.1

属性

属性	必需	说明
id	是	组的唯一 ID。

id attribute

必需。 组的唯一标识符。 是一个最多为 125 个字符的字符串。 这在清单中的所有 Group 元素中必须是唯一的。

子元素

元素	必需	说明
Label	是	组的标签。
Tooltip	否	组的工具提示。
Icon	是	组的图像。 Outlook 加载项不支持。
Control	否	表示 Control 对象。 可以为零或更多。
OfficeControl	否	表示内置 Office 控件之一。 可以为零或更多。 仅在 PowerPoint 加载项中受支持。
OverriddenByRibbonApi	否	指定组是否应显示在支持自定义上下文选项卡的应用程序和平台组合上。 Outlook 加载项不支持。

标签

必需。 组的标签。 resid 属性不能超过 32 个字符，并且必须设置为 Resources 元素中 ShortStrings> 元素中<String> 元素的 id< 属性的值。

工具提示

外接程序类型： 邮件

仅在以下 VersionOverrides 架构中有效：

• 邮件 1.1

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

与以下要求集关联：

• AddinCommands 1.1

可选。 组的工具提示。 resid 属性不能超过 32 个字符，并且必须设置为 String> 元素的<id 属性的值。 <String> 元素是 LongStrings> 元素的<子元素，它是 Resources 元素的子元素。

注意

此子元素仅在 Outlook 外接程序中受支持。

图标

必填。 如果选项卡包含大量组，并且程序窗口已调整大小，则可能会改为显示指定的图像。

注意

Outlook 加载项不支持此子元素。

控制

可选，但如果不存在，则必须至少有一个 <OfficeControl>。 有关支持的控件类型的详细信息，请参阅 Control 元素。 清单中 Control> 和 OfficeControl 的顺序是可互换的<，如果有多个元素，则它们可以相互混用，但所有元素都必须在 Icon> 元素下方<。><

<Group id="Contoso.CustomTab1.group1">
    <Label resid="CustomTabGroupLabel"/>
    <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.Button1">
        <!-- information on the control -->
    </Control>
    <!-- other controls, as needed -->
</Group>

OfficeControl

可选，但如果不存在，则必须至少有一个 <控件>。 在包含 <OfficeControl> 元素的组中包括一个或多个内置 Office 控件。 属性 id 指定内置 Office 控件的 ID。 若要查找控件的 ID，请参阅 查找控件和控件组的 ID。 清单中 Control> 和 OfficeControl 的顺序是可互换的<，如果有多个元素，则它们可以相互混用，但所有元素都必须在 Icon> 元素下方<。><

外接程序类型： 任务窗格

仅在以下 VersionOverrides 架构中有效：

• 任务窗格 1.0

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

与以下要求集关联：

• AddinCommands 1.3

注意

此子元素仅在 PowerPoint 外接程序中受支持。

<Group id="Contoso.CustomTab2.group2">
    <Label resid="CustomTabGroupLabel"/>
    <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 -->
    </Control>
    <OfficeControl id="Superscript" />
    <!-- other controls, as needed -->
</Group>

OverriddenByRibbonApi

可选 (布尔) 。 指定组>是否<隐藏在支持在运行时在功能区上安装自定义上下文选项卡的 API 的应用程序和平台组合上。 如果不存在，则默认值为 false。 如果使用，<则 OverriddenByRibbonApi> 必须是 Group 的第一个子级<>。 有关详细信息，请参阅 OverriddenByRibbonApi。

注意

Outlook 加载项不支持此子元素。

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.CustomTab">
    <Group id="Contoso.CustomTab.group1">
      <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
      <!-- other child elements of the group -->
    </Group>
    <Label resid="customTabLabel"/>
  </CustomTab>
</ExtensionPoint>