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.

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, ajoutez un élément OfficeGroup en tant qu’élément enfant dans l’élément CustomTab> parent<. L’attribut id de l’élément <OfficeGroup> est défini sur l’ID du groupe intégré. Consultez Rechercher les ID des contrôles et des groupes de contrôles.

L’exemple de balisage suivant ajoute le groupe de contrôle Paragraphe Office à un onglet personnalisé et le positionne pour qu’il apparaisse juste après un groupe personnalisé.

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

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 élément OfficeControl en tant qu’élément enfant dans l’élément group> parent<. L’attribut id de l’élément <OfficeControl> est défini sur l’ID du contrôle intégré. Consultez Rechercher les ID des contrôles et des groupes de contrôles.

L’exemple de balisage suivant ajoute le contrôle Office Superscript à un groupe personnalisé et le positionne pour qu’il apparaisse juste après un bouton personnalisé.

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

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, ajoutez une référence à l’ensemble de conditions requises dans la <section Configuration requise> du manifeste. 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.