Поделиться через


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

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

Примечание.

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

Важно!

Функция надстройки, описанная в этой статье, доступна только в PowerPoint в Интернете, в Windows и на Mac.

Откройте вкладку с типом манифеста, используемого вашей надстройкой, для получения сведений о разметке манифеста.

Примечание.

Унифицированный манифест для Microsoft 365 можно использовать в рабочих надстройках Outlook. Он доступен только в качестве предварительной версии для надстроек Excel, PowerPoint и Word.

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

Чтобы вставить встроенную группу элементов управления Office в настраиваемую вкладку, добавьте объект group со свойством builtInGroupId вместо свойства id в массив groups объекта пользовательской вкладки. Задайте идентификатор встроенной группы. См . раздел Поиск идентификаторов элементов управления и групп элементов управления. Встроенный объект группы не должен иметь других свойств.

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

"extensions": [
    ...
    {
        ...
        "ribbons": [
            ...
            {
                ...
                "tabs": [
                    {
                        "id": "MyTab",
                        ...
                        "groups": [
                            ... // Optionally, other groups in the tab
                            {
                                "builtInGroupId": "Paragraph"
                            },
                            ... // Optionally, other groups in the tab
                        ]
                    }
                ]
            }
        ]
    }
]

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

Чтобы вставить встроенный элемент управления Office в настраиваемую группу, добавьте объект элемента управления со свойством builtInControlId вместо свойства id в массив controls объекта настраиваемой группы. Задайте идентификатор встроенного элемента управления. См . раздел Поиск идентификаторов элементов управления и групп элементов управления. Встроенный объект элемента управления не должен иметь других свойств.

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

"extensions": [
    ...
    {
        ...
        "ribbons": [
            ...
            {
                ...
                "tabs": [
                    {
                        ...
                        "groups": [
                            {
                                "id": "MyGroup",
                                ...
                                "controls": [
                                    ... // Optionally, other controls in the group
                                    {
                                        "builtInControlId": "Superscript"
                                    },
                                    ... // Optionally, other controls in the group
                                ]
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

Примечание.

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

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

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

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

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