Positionner un onglet personnalisé sur le ruban

Vous pouvez spécifier l’emplacement où vous souhaitez que l’onglet personnalisé de votre complément apparaisse sur le ruban de l’application Office en utilisant le balisage dans le manifeste du complément.

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 et le balisage décrits dans cet article sont uniquement disponibles dans PowerPoint sur le web.
• Le balisage décrit dans cet article fonctionne uniquement sur les plateformes qui prennent en charge l’ensemble de conditions requises AddinCommands 1.3. Consultez Comportement sur les plateformes non prises en charge ci-dessous.

Spécifiez l’emplacement où vous souhaitez qu’un onglet personnalisé apparaisse en identifiant l’onglet Office intégré auquel vous souhaitez qu’il se trouve à côté et en spécifiant s’il doit se trouver sur le côté gauche ou droit de l’onglet intégré. Définissez ces spécifications en incluant un élément InsertBefore (gauche) ou InsertAfter (droite) dans l’élément CustomTab du manifeste de votre complément. (Vous ne pouvez pas avoir les deux éléments.)

Dans l’exemple suivant, l’onglet personnalisé est configuré pour apparaître juste après l’onglet Révision . Notez que la valeur de l’élément <InsertAfter> est l’ID de l’onglet Office intégré.

<ExtensionPoint xsi:type="ContosoRibbonTab">
  <CustomTab id="Contoso.TabCustom2">
    <Group id="Contoso.TabCustom2.group2">
       <!-- additional markup omitted -->
    </Group>
    <Label resid="customTabLabel1" />
    <InsertAfter>TabReview</InsertAfter>
  </CustomTab>
</ExtensionPoint>

Gardez à l’esprit les points suivants.

• Les <éléments InsertBefore> et <InsertAfter> sont facultatifs. Si vous n’utilisez ni l’un ni l’autre, votre onglet personnalisé apparaît comme l’onglet le plus à droite du ruban.
• Les <éléments InsertBefore> et <InsertAfter> s’excluent mutuellement. Vous ne pouvez pas utiliser les deux.
• Si l’utilisateur installe plusieurs compléments dont l’onglet personnalisé est configuré pour le même emplacement, par exemple après l’onglet Révision , l’onglet du dernier complément installé se trouve à cet emplacement. Les onglets des compléments précédemment installés sont déplacés à un emplacement unique. Par exemple, l’utilisateur installe les compléments A, B et C dans cet ordre et tous sont configurés pour insérer un onglet après l’onglet Révision , puis les onglets apparaissent dans cet ordre : Review, AddinCTab, AddinBTab, AddinATab.
• Les utilisateurs peuvent personnaliser le ruban dans l’application Office. Par exemple, un utilisateur peut déplacer ou masquer l’onglet de votre complément. Vous ne pouvez pas l’empêcher ou détecter qu’elle s’est produite.
• Si un utilisateur déplace l’un des onglets intégrés, Office interprète les <éléments InsertBefore> et <InsertAfter> en fonction de l’emplacement par défaut de l’onglet intégré. Par exemple, si l’utilisateur déplace l’onglet Révision à l’extrémité droite du ruban, Office interprète le balisage de l’exemple précédent comme signifiant « placer l’onglet personnalisé juste à droite de l’emplacement où se trouve l’onglet Révision par défaut ».

Spécifier l’onglet qui a le focus à l’ouverture du document

Office donne toujours le focus par défaut à l’onglet qui se trouve immédiatement à droite de l’onglet Fichier . Par défaut, il s’agit de l’onglet Accueil . Si vous configurez votre onglet personnalisé pour qu’il soit avant l’onglet Accueil , avec <InsertBefore>TabHome</InsertBefore>, votre onglet personnalisé aura le focus lorsque le document s’ouvre.

Importante

Donner une importance excessive à votre complément dérange et contrarie les utilisateurs et les administrateurs. Ne positionnez pas un onglet personnalisé avant l’onglet Accueil , sauf si votre complément est le principal moyen d’interagir avec le document.

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 votre onglet personnalisé s’affiche sous la forme de l’onglet le plus à droite du ruban. 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 autre expérience quand AddinCommands 1.3 n’est pas pris en charge, comme décrit dans Conception d’expériences alternatives. Par exemple, si votre complément contient des instructions qui supposent que l’onglet personnalisé est là où vous le souhaitez, vous pouvez avoir une autre version qui suppose que l’onglet est le plus à droite.