可以使用加载项清单中的标记将内置 Office 按钮插入到 Office 功能区上的自定义控件组中。 (不能将自定义外接程序命令插入内置 Office 组中。) 还可以将整个内置 Office 控件组插入到自定义功能区选项卡中。
注意
本文假设你熟悉 加载项命令的基本概念一文。 如果最近没有这样做，请查看它。
重要
本文中所述的加载项功能仅在 PowerPoint 网页版、Windows 版和 Mac 版中可用。
打开加载项使用的清单类型的选项卡，了解清单标记的详细信息。
注意
Microsoft 365 的统一清单可用于生产 Outlook 加载项。它仅作为 Excel、PowerPoint 和 Word 加载项的预览版提供。
将内置控件组插入自定义选项卡
若要将内置 Office 控件组插入自定义选项卡，请将具有 "builtInGroupId" 属性 的 "id" 组对象而不是属性 添加到 "groups" 自定义选项卡对象的数组中。 设置为内置组的 ID。 请参阅 查找控件和控件组的 ID。
内置组对象不应具有其他属性。
以下示例将 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" 自定义组对象的数组。 设置为内置控件的 ID。 请参阅 查找控件和控件组的 ID。
内置控件对象不应具有其他属性。
以下示例将 Office 上标控件添加到自定义组。
"extensions": [
...
{
...
"ribbons": [
...
{
...
"tabs": [
{
...
"groups": [
{
"id": "MyGroup",
...
"controls": [
... // Optionally, other controls in the group.
{
"builtInControlId": "Superscript"
},
... // Optionally, other controls in the group.
]
}
]
}
]
}
]
}
]
注意
用户可以在 Office 应用程序中自定义功能区。 任何用户自定义项都将替代清单设置。 例如，用户可以从任何组中删除按钮，并从选项卡中删除任何组。
查找控件和控件组的 ID
支持的控件和控件组的 ID 位于存储库 Office 控制 ID 中的文件中。 按照该存储库的自述文件中的说明进行作。
不受支持的平台上的行为
如果外接程序安装在不支持 要求集 AddinCommands 1.3 的平台上，则忽略本文中所述的标记，并且内置 Office 控件/组不会显示在自定义组/选项卡中。 若要防止加载项安装在不支持标记的平台上，必须在清单中指定 AddinCommands 1.3 作为安装要求。 有关说明，请参阅 指定哪些 Office 版本和平台可以托管加载项。 或者，将外接程序设计为在不支持 AddinCommands 1.3 时提供体验，如 设计备用体验中所述。 例如，如果外接程序包含的指令假定内置按钮位于自定义组中，则可以设计一个版本，假定内置按钮仅位于其通常位置。