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

  • 项目

可以使用加载项清单中的标记将内置 Office 按钮插入到 Office 功能区上的自定义控件组中。 (不能将自定义外接程序命令插入内置 Office 组中。) 还可以将整个内置 Office 控件组插入到自定义功能区选项卡中。

注意

本文假设你熟悉 加载项命令的基本概念一文。 如果最近没有这样做，请查看它。

重要

  • 本文中所述的加载项功能和标记仅在 PowerPoint web 版、Windows 和 Mac 上可用。
  • 本文中所述的标记仅适用于支持要求集 AddinCommands 1.3 的平台。 请参阅后面的不 受支持的平台上的行为部分。

将内置控件组插入自定义选项卡

若要在选项卡中插入内置 Office 控件组，请在父 <CustomTab> 元素中添加 OfficeGroup 元素作为子元素。 idOfficeGroup> 元素的< 的 属性设置为内置组的 ID。 请参阅 查找控件和控件组的 ID。

下面的标记示例将 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 控件插入自定义组中，请在父 <Group> 元素中添加 OfficeControl 元素作为子元素。 idOfficeControl> 元素的< 属性设置为内置控件的 ID。 请参阅 查找控件和控件组的 ID。

下面的标记示例将 Office 上标控件添加到自定义组，并将其定位为显示在自定义按钮之后。

<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 应用程序中自定义功能区。 任何用户自定义项都将替代清单设置。 例如，用户可以从任何组中删除按钮，并从选项卡中删除任何组。

查找控件和控件组的 ID

支持的控件和控件组的 ID 位于存储库 Office 控制 ID 中的文件中。 按照该存储库的自述文件中的说明进行操作。

不受支持的平台上的行为

如果外接程序安装在不支持 要求集 AddinCommands 1.3 的平台上，则忽略本文中所述的标记，并且内置 Office 控件/组不会显示在自定义组/选项卡中。 若要防止加载项安装在不支持标记的平台上，请在清单的“要求>”部分中添加对要求集<的引用。 有关说明，请参阅 指定哪些 Office 版本和平台可以托管加载项。 或者，将外接程序设计为在不支持 AddinCommands 1.3 时提供体验，如 设计备用体验中所述。 例如，如果外接程序包含的指令假定内置按钮位于自定义组中，则可以设计一个版本，假定内置按钮仅位于其通常位置。