Integración de botones de Office integrados en pestañas y grupos de control personalizados

Puede insertar botones de Office integrados en los grupos de control personalizados en la cinta de Opciones de Office mediante el marcado en el manifiesto del complemento. (No puede insertar los comandos de complemento personalizados en un grupo integrado de Office). También puede insertar grupos de control integrados completos de Office en las pestañas de la cinta de opciones personalizadas.

Nota:

En este artículo se supone que está familiarizado con los conceptos básicos de los comandos de complemento. Revise si no lo ha hecho recientemente.

Importante

• La característica y el marcado del complemento descritos en este artículo solo están disponibles en PowerPoint en la Web, en Windows y en Mac.
• El marcado descrito en este artículo solo funciona en plataformas que admiten el conjunto de requisitos AddinCommands 1.3. Consulte la sección posterior Comportamiento en plataformas no admitidas.

Insertar un grupo de control integrado en una pestaña personalizada

Para insertar un grupo de controles de Office integrado en una pestaña, agregue un elemento OfficeGroup como elemento secundario en el elemento CustomTab> primario<. El id atributo del elemento OfficeGroup<> se establece en el identificador del grupo integrado. Consulte Búsqueda de los identificadores de controles y grupos de controles.

En el siguiente ejemplo de marcado se agrega el grupo de control Párrafo de Office a una pestaña personalizada y se coloca para que aparezca justo después de un grupo personalizado.

<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>

Insertar un control integrado en un grupo personalizado

Para insertar un control de Office integrado en un grupo personalizado, agregue un elemento OfficeControl como elemento secundario en el elemento group> primario<. El id atributo del <elemento OfficeControl> se establece en el identificador del control integrado. Consulte Búsqueda de los identificadores de controles y grupos de controles.

En el siguiente ejemplo de marcado se agrega el control Superscript de Office a un grupo personalizado y se coloca para que aparezca justo después de un botón personalizado.

<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>

Nota:

Los usuarios pueden personalizar la cinta de opciones en la aplicación de Office. Las personalizaciones de usuario invalidarán la configuración del manifiesto. Por ejemplo, un usuario puede quitar un botón de cualquier grupo y quitar cualquier grupo de una pestaña.

Búsqueda de los identificadores de controles y grupos de control

Los identificadores de los controles y grupos de controles admitidos se encuentran en archivos en los identificadores de control de Office del repositorio. Siga las instrucciones del archivo Léame de ese repositorio.

Comportamiento en plataformas no admitidas

Si el complemento está instalado en una plataforma que no admite el conjunto de requisitos AddinCommands 1.3, el marcado descrito en este artículo se omite y los controles o grupos de Office integrados no aparecerán en los grupos o pestañas personalizados. Para evitar que el complemento se instale en plataformas que no admiten el marcado, agregue una referencia al conjunto de requisitos en la <sección Requisitos> del manifiesto. Para obtener instrucciones, vea Especificar qué versiones y plataformas de Office pueden hospedar el complemento. Como alternativa, diseñe el complemento para que tenga una experiencia cuando no se admita AddinCommands 1.3 , como se describe en Diseño para experiencias alternativas. Por ejemplo, si el complemento contiene instrucciones que suponen que los botones integrados están en los grupos personalizados, podría diseñar una versión que suponga que los botones integrados solo están en sus lugares habituales.