Интеграция встроенных кнопок Office в пользовательские группы управления и вкладки

Встроенные кнопки Office можно вставить в пользовательские группы элементов управления на ленте Office с помощью разметки в манифесте надстройки. (Вы не можете вставлять пользовательские команды надстройки во встроенную группу Office.) Вы также можете вставить все встроенные группы элементов управления Office на настраиваемые вкладки ленты.

Примечание.

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

Важно!

• Функция надстройки и разметка, описанные в этой статье, доступны только в PowerPoint в Интернете, Windows и Mac.
• Разметка, описанная в этой статье, работает только на платформах, поддерживающих набор требований AddinCommands 1.3. См. раздел Поведение на неподдерживаемых платформах.

Вставка встроенной группы элементов управления в настраиваемую вкладку

Чтобы вставить встроенную группу элементов управления Office на вкладку, добавьте элемент OfficeGroup в качестве дочернего элемента родительского <элемента CustomTab> . Атрибут id<элемента OfficeGroup> задается в качестве идентификатора встроенной группы. См . раздел Поиск идентификаторов элементов управления и групп элементов управления.

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

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom1">
    <Group id="Contoso.myCustomTab.group1">
       <!-- additional markup omitted -->
    </Group>
    <OfficeGroup id="Paragraph" />
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

Вставка встроенного элемента управления в настраиваемую группу

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

В следующем примере разметки элемент управления Office Superscript добавляется в настраиваемую группу и помещает его для отображения сразу после настраиваемой кнопки.

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom2">
    <Group id="Contoso.TabCustom2.group1">
        <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.Button1">
            <!-- Information on the control omitted. -->
        </Control>
        <OfficeControl id="Superscript" />
        <!-- Other controls, as needed. -->
    </Group>
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

Примечание.

Пользователи могут настраивать ленту в приложении Office. Любые пользовательские настройки переопределяют параметры манифеста. Например, пользователь может удалить кнопку из любой группы и любую группу с вкладки.

Поиск идентификаторов элементов управления и групп элементов управления

Идентификаторы поддерживаемых элементов управления и групп элементов управления находятся в файлах в идентификаторах элементов управления Office репозитория. Следуйте инструкциям в файле ReadMe этого репозитория.

Поведение на неподдерживаемых платформах

Если надстройка установлена на платформе, которая не поддерживает набор требований AddinCommands 1.3, то описанная в этой статье разметка игнорируется, а встроенные элементы управления и группы Office не будут отображаться в пользовательских группах и вкладках. Чтобы предотвратить установку надстройки на платформах, которые не поддерживают разметку, добавьте ссылку на набор требований в <разделе Требования> манифеста. Инструкции см . в разделе Указание версий и платформ Office, которые могут размещать надстройку. Кроме того, создайте надстройку так, чтобы она работала, когда AddinCommands 1.3 не поддерживается, как описано в разделе Проектирование альтернативных возможностей. Например, если надстройка содержит инструкции, предполагающие, что встроенные кнопки находятся в пользовательских группах, можно создать версию, предполагающую, что встроенные кнопки находятся только в обычных местах.