Элемент CustomTab

  • Статья

Определяет настраиваемую вкладку для ленты Office. Добавьте элементы управления и группы ленты для надстройки на одну из встроенных вкладок Office или на собственную настраиваемую вкладку. <Используйте элемент CustomTab> , чтобы добавить настраиваемую вкладку на ленту. На пользовательских вкладках надстройка может иметь настраиваемые или встроенные группы. Надстройка может создать не более одной специальной вкладки.

Важно!

В Outlook для Mac <элемент CustomTab> недоступен, но вы можете поместить настраиваемые группы элементов управления в один из встроенных элементов OfficeTab. Вы не можете разместить встроенные группы на встроенных вкладках в Outlook на любой платформе.

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

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

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

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

Примечание.

Некоторые дочерние элементы недопустимы в схемах почты. См. раздел Дочерние элементы.

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

Атрибуты

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

Атрибут id

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

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

Элемент Обязательный Описание
Group Нет Определяет группу команд.
OfficeGroup Нет Представляет встроенную группу элементов управления Office. Важно! Недоступно в Outlook.
Label Да Метка для CustomTab.
InsertAfter Нет Указывает, что настраиваемая вкладка должна находиться сразу после указанной встроенной вкладки Office. Важно: доступно только в PowerPoint.
InsertBefore Нет Указывает, что настраиваемая вкладка должна находиться непосредственно перед указанной встроенной вкладкой Office. Важно: доступно только в PowerPoint.

Группа

Необязательный, но если он отсутствует, должен быть хотя бы один <элемент OfficeGroup> . См. элемент Group. <Порядок групп> и <OfficeGroup> в манифесте должен совпадать с порядком их отображения на настраиваемой вкладке. Они могут быть перемешаны, если есть несколько элементов, но все они должны находиться над элементом <Label>.

OfficeGroup

Необязательный, но если он отсутствует, должен быть хотя бы один <элемент Group> . Представляет встроенную группу элементов управления Office. Атрибут id задает идентификатор встроенной группы Office. Чтобы найти идентификатор встроенной группы, см. раздел Поиск идентификаторов элементов управления и групп элементов управления. <Порядок групп> и <OfficeGroup> в манифесте должен совпадать с порядком их отображения на настраиваемой вкладке. Они могут быть перемешаны, если есть несколько элементов, но все они должны находиться над элементом <Label>.

Важно!

Элемент <OfficeGroup> недоступен в Outlook. В PowerPoint она доступна в предварительной версии для Mac и Windows; но доступен для рабочих надстроек в PowerPoint в Интернете.

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

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

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

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

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

Label (Tab)

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

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

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

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

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

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

InsertAfter

Необязательный параметр. Указывает, что настраиваемая вкладка должна находиться сразу после указанной встроенной вкладки Office. Значением элемента является идентификатор встроенной вкладки, например TabHome или TabReview. Список встроенных вкладок см. в разделе OfficeTab. Если он присутствует, должен находиться после <элемента Label> . Невозможно использовать insertAfter<> и <InsertBefore>.

Важно!

Элемент <InsertAfter> доступен только в PowerPoint.

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

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

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

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

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

InsertBefore

Необязательный параметр. Указывает, что настраиваемая вкладка должна находиться непосредственно перед указанной встроенной вкладкой Office. Значением элемента является идентификатор встроенной вкладки, например TabHome или TabReview. Значением элемента является идентификатор встроенной вкладки, например 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 Superscript добавляется в настраиваемую группу и помещает его для отображения сразу после настраиваемой кнопки.

<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>