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 de complemento descrita en este artículo solo está disponible en PowerPoint en la web, en Windows y en Mac.
Abra la pestaña del tipo de manifiesto que usa el complemento para obtener los detalles del marcado del manifiesto.
Nota:
El manifiesto unificado para Microsoft 365 se puede usar en complementos de Outlook de producción. Solo está disponible como versión preliminar para excel, PowerPoint y complementos de Word.
Insertar un grupo de control integrado en una pestaña personalizada
Para insertar un grupo de control de Office integrado en una pestaña personalizada, agregue un objeto de grupo con una propiedad "builtInGroupId" en lugar de una propiedad "id" a la matriz "groups" del objeto tab personalizado. Establezca en el identificador del grupo integrado. Consulte Búsqueda de los identificadores de controles y grupos de controles. El objeto de grupo integrado no debe tener ninguna otra propiedad.
En el ejemplo siguiente se agrega el grupo de control Párrafo de Office a una pestaña personalizada.
"extensions": [
...
{
...
"ribbons": [
...
{
...
"tabs": [
{
"id": "MyTab",
...
"groups": [
... // Optionally, other groups in the tab
{
"builtInGroupId": "Paragraph"
},
... // Optionally, other groups in the tab
]
}
]
}
]
}
]
Insertar un control integrado en un grupo personalizado
Para insertar un control de Office integrado en un grupo personalizado, agregue un objeto de control con una propiedad "builtInControlId" en lugar de una propiedad "id" a la matriz "controls" del objeto de grupo personalizado. Establézcalo en el identificador del control integrado. Consulte Búsqueda de los identificadores de controles y grupos de controles. El objeto de control integrado no debe tener ninguna otra propiedad.
En el ejemplo siguiente se agrega el control Superscript de Office a un grupo personalizado.
"extensions": [
...
{
...
"ribbons": [
...
{
...
"tabs": [
{
...
"groups": [
{
"id": "MyGroup",
...
"controls": [
... // Optionally, other controls in the group
{
"builtInControlId": "Superscript"
},
... // Optionally, other controls in the group
]
}
]
}
]
}
]
}
]
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, debe especificar AddinCommands 1.3 en el manifiesto como requisito para la instalación. 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.