Intégrer des boutons Office intégrés dans des groupes de contrôle et des onglets personnalisés
Vous pouvez insérer des boutons Office intégrés dans vos groupes de contrôles personnalisés sur le ruban Office à l’aide du balisage dans le manifeste du complément. (Vous ne pouvez pas insérer vos commandes de complément personnalisées dans un groupe Office intégré.) Vous pouvez également insérer des groupes de contrôle Office intégrés entiers dans vos onglets de ruban personnalisés.
Remarque
Cet article part du principe que vous êtes familiarisé avec l’article Concepts de base pour les commandes de complément. Veuillez le consulter si vous ne l’avez pas fait récemment.
Importante
La fonctionnalité de complément décrite dans cet article est disponible uniquement dans PowerPoint sur le web, sur Windows et sur Mac.
Ouvrez l’onglet correspondant au type de manifeste utilisé par votre complément pour obtenir les détails du balisage du manifeste.
Remarque
Le manifeste unifié pour Microsoft 365 peut être utilisé dans les compléments Outlook de production. Il est disponible uniquement en préversion pour les compléments Excel, PowerPoint et Word.
Insérer un groupe de contrôles intégré dans un onglet personnalisé
Pour insérer un groupe de contrôle Office intégré dans un onglet personnalisé, ajoutez un objet group avec une propriété « builtInGroupId » au lieu d’une propriété « id » au tableau « groups » de votre objet onglet personnalisé. Définissez sur l’ID du groupe intégré. Consultez Rechercher les ID des contrôles et des groupes de contrôles. L’objet de groupe intégré ne doit pas avoir d’autres propriétés.
L’exemple suivant ajoute le groupe de contrôle Paragraphe Office à un onglet personnalisé.
"extensions": [
...
{
...
"ribbons": [
...
{
...
"tabs": [
{
"id": "MyTab",
...
"groups": [
... // Optionally, other groups in the tab
{
"builtInGroupId": "Paragraph"
},
... // Optionally, other groups in the tab
]
}
]
}
]
}
]
Insérer un contrôle intégré dans un groupe personnalisé
Pour insérer un contrôle Office intégré dans un groupe personnalisé, ajoutez un objet de contrôle avec une propriété « builtInControlId » au lieu d’une propriété « id » au tableau « controls » de votre objet de groupe personnalisé. Définissez sur l’ID du contrôle intégré. Consultez Rechercher les ID des contrôles et des groupes de contrôles. L’objet de contrôle intégré ne doit pas avoir d’autres propriétés.
L’exemple suivant ajoute le contrôle Office Superscript à un groupe personnalisé.
"extensions": [
...
{
...
"ribbons": [
...
{
...
"tabs": [
{
...
"groups": [
{
"id": "MyGroup",
...
"controls": [
... // Optionally, other controls in the group
{
"builtInControlId": "Superscript"
},
... // Optionally, other controls in the group
]
}
]
}
]
}
]
}
]
Remarque
Les utilisateurs peuvent personnaliser le ruban dans l’application Office. Toutes les personnalisations utilisateur remplacent vos paramètres de manifeste. Par exemple, un utilisateur peut supprimer un bouton de n’importe quel groupe et supprimer n’importe quel groupe d’un onglet.
Rechercher les ID des contrôles et des groupes de contrôles
Les ID des contrôles et groupes de contrôles pris en charge se trouvent dans des fichiers dans les ID de contrôle Office du dépôt. Suivez les instructions du fichier ReadMe de ce dépôt.
Comportement sur les plateformes non prises en charge
Si votre complément est installé sur une plateforme qui ne prend pas en charge l’ensemble de conditions requises AddinCommands 1.3, le balisage décrit dans cet article est ignoré et les contrôles/groupes Office intégrés n’apparaissent pas dans vos groupes/onglets personnalisés. Pour empêcher l’installation de votre complément sur des plateformes qui ne prennent pas en charge le balisage, vous devez spécifier AddinCommands 1.3 dans le manifeste comme condition requise pour l’installation. Pour obtenir des instructions, voir Spécifier les versions et plateformes Office qui peuvent héberger votre complément. Vous pouvez également concevoir votre complément pour qu’il ait une expérience lorsque AddinCommands 1.3 n’est pas pris en charge, comme décrit dans Conception d’autres expériences. Par exemple, si votre complément contient des instructions qui supposent que les boutons intégrés se trouvent dans vos groupes personnalisés, vous pouvez concevoir une version qui suppose que les boutons intégrés se trouvent uniquement à leur emplacement habituel.