Элемент Group

  • Статья

Определяет группу элементов управления пользовательского интерфейса на вкладке. На пользовательских вкладках надстройка может создавать несколько групп. Надстройка может создать не более одной специальной вкладки.

Тип надстройки: Область задач, почта

Допустимо только в следующих схемах VersionOverrides:

  • Область задач 1.0
  • Почта 1.0
  • Почта 1.1

Дополнительные сведения см. в разделе Переопределения версий в манифесте.

Связаны с этими наборами требований:

Атрибуты

Атрибут Обязательный Описание
id Да Уникальный идентификатор группы.

Атрибут id

Обязательно. Уникальный идентификатор группы. Это строка длиной до 125 символов. Он должен быть уникальным для всех элементов Group в манифесте.

Дочерние элементы

Элемент Обязательный Описание
Label Да Метка для группы.
Icon Да Изображение для группы. Не поддерживается в надстройках Outlook.
Control Нет Представляет объект Control. Может быть равно нулю или больше.
OfficeControl Нет Представляет один из встроенных элементов управления Office. Может быть равно нулю или больше. Поддерживается только в надстройках PowerPoint.
OverriddenByRibbonApi Нет Указывает, должна ли группа отображаться в сочетаниях приложений и платформ, поддерживающих пользовательские контекстные вкладки. Не поддерживается в надстройках Outlook.

Метка

Обязательный элемент. Метка группы. Атрибут resid может содержать не более 32 символов и должен иметь значение атрибута<id элемента String> в <элементе ShortStrings> в элементе Resources .

Значок

Обязательно. Если вкладка содержит много групп и размер окна программы изменен, вместо этого может отобразиться указанное изображение.

Примечание.

Этот дочерний элемент не поддерживается в надстройках 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

Необязательный, но если отсутствует, должен быть хотя бы один <элемент управления>. Включите в группу один или несколько встроенных элементов управления Office с <элементами OfficeControl> . Атрибут id задает идентификатор встроенного элемента управления Office. Чтобы найти идентификатор элемента управления, см. раздел Поиск идентификаторов элементов управления и групп элементов управления. Порядок <элементов Control> и <OfficeControl> в манифесте является взаимозаменяемым, и их можно скрестить при наличии нескольких элементов, но все они должны находиться под элементом <Icon> .

Тип надстройки: надстройки области задач

Допустимо только в следующих схемах VersionOverrides:

  • Область задач 1.0

Дополнительные сведения см. в разделе Переопределения версий в манифесте.

Связаны с этими наборами требований:

Примечание.

Этот дочерний элемент поддерживается только в надстройках 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> должен быть первым дочерним элементом <Группы>. Дополнительные сведения см. в разделе 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>