Интеграция встроенных кнопок 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 не поддерживается, как описано в разделе Проектирование альтернативных возможностей. Например, если надстройка содержит инструкции, предполагающие, что встроенные кнопки находятся в пользовательских группах, можно создать версию, предполагающую, что встроенные кнопки находятся только в обычных местах.
Office Add-ins