通过

将内置 Office 按钮集成到自定义控件组和选项卡

  • 项目

可以使用加载项清单中的标记将内置 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 时提供体验，如 设计备用体验中所述。 例如，如果外接程序包含的指令假定内置按钮位于自定义组中，则可以设计一个版本，假定内置按钮仅位于其通常位置。