Элемент CustomTab

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

Важно!

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

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

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

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

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

Примечание.

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

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

Атрибуты

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

Атрибут id

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

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

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

Группа

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

Группа OfficeGroup

Необязательно, но если отсутствует, должен быть хотя бы один <элемент группы> . Представляет встроенную группу элементов управления 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>.

Важно!

Элемент< "Вставить после>" доступен только в PowerPoint.

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

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

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

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

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

InsertBefore

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

Важно!

Элемент <"Вставить до"> доступен только в PowerPoint.

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

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

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

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

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

Примеры

В следующем примере разметки группа элементов управления "Абзац Office" добавляется на настраиваемую вкладку, после которой она размещается сразу после настраиваемой группы.

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <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="PrimaryCommandSurface">
  <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>
  • Last updated on