Partager via

Élément CustomTab

  • Article

Définit un onglet personnalisé pour le ruban Office. Ajoutez des contrôles de ruban et des groupes pour le complément à l’un des onglets Office de build ou à votre propre onglet personnalisé. Utilisez l’élément <CustomTab> pour ajouter un onglet personnalisé au ruban. Sous les onglets personnalisés, le complément peut avoir des groupes personnalisés ou intégrés. Les compléments sont limités à un onglet personnalisé.

Importante

Dans Outlook sur Mac, l’élément <CustomTab> n’est pas disponible, mais vous pouvez placer des groupes de contrôles personnalisés sur l’un des officetabsintégrés à la place. Vous ne pouvez pas placer des groupes intégrés sur des onglets intégrés dans Outlook sur n’importe quelle plateforme.

Type de complément : Volet Office, Courrier

Valide uniquement dans les schémas VersionOverrides suivants :

  • Volet De tâches 1.0
  • Mail 1.0
  • Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Remarque

Certains éléments enfants ne sont pas valides dans les schémas de messagerie. Consultez Éléments enfants.

Associé à ces ensembles de conditions requises :

Attributs

Attribut Obligatoire Description
id Oui ID unique pour l’onglet personnalisé.

Attribut id

Obligatoire. Identificateur unique de l’onglet personnalisé. Il s’agit d’une chaîne avec un maximum de 125 caractères. Ce doit être unique dans le manifeste.

Éléments enfants

Élément Obligatoire Description
Group Non Définit un groupe de commandes.
OfficeGroup Non Représente un groupe de contrôles Office intégré. Important : non disponible dans Outlook.
Label Oui Étiquette du CustomTab.
InsertAfter Non Spécifie que l’onglet personnalisé doit se trouver immédiatement après un onglet Office intégré spécifié. Important : disponible uniquement dans PowerPoint.
InsertBefore Non Spécifie que l’onglet personnalisé doit se trouver immédiatement avant un onglet Office intégré spécifié. Important : disponible uniquement dans PowerPoint.

Group

Facultatif, mais s’il n’est pas présent, il doit y avoir au moins un <élément OfficeGroup> . Voir Élément group. L’ordre de <Groupe> et <OfficeGroup> dans le manifeste doit correspondre à l’ordre dans lequel vous souhaitez qu’ils apparaissent sous l’onglet personnalisé. Ils peuvent être entremêlés s’il existe plusieurs éléments, mais tous doivent se trouver au-dessus de l’élément <Label> .

OfficeGroup

Facultatif, mais s’il n’est pas présent, il doit y avoir au moins un <élément Group> . Représente un groupe de contrôles Office intégré. L’attribut id spécifie l’ID du groupe Office intégré. Pour trouver l’ID d’un groupe intégré, consultez Rechercher les ID des contrôles et des groupes de contrôles. L’ordre de <Groupe> et <OfficeGroup> dans le manifeste doit correspondre à l’ordre dans lequel vous souhaitez qu’ils apparaissent sous l’onglet personnalisé. Ils peuvent être entremêlés s’il existe plusieurs éléments, mais tous doivent se trouver au-dessus de l’élément <Label> .

Importante

L’élément <OfficeGroup> n’est pas disponible dans Outlook. Dans PowerPoint, il est en préversion pour Mac et Windows ; mais est disponible pour les compléments de production dans PowerPoint sur le web.

Type de complément : volet Office

Valide uniquement dans les schémas VersionOverrides suivants :

  • Volet De tâches 1.0

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

Label (Tab)

Obligatoire. Étiquette de l’onglet personnalisé. L’attribut resid ne peut pas comporter plus de 32 caractères et doit être défini sur la valeur de l’attribut id d’un <élément String> dans l’élément< ShortStrings> de l’élément Resources.

Type de complément : Volet Office, Courrier

Valide uniquement dans les schémas VersionOverrides suivants :

  • Volet De tâches 1.0
  • Mail 1.0
  • Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

InsertAfter

Optional. Spécifie que l’onglet personnalisé doit se trouver immédiatement après un onglet Office intégré spécifié. La valeur de l’élément est l’ID de l’onglet intégré, par TabHome exemple ou TabReview. Pour obtenir la liste des onglets intégrés, voir OfficeTab. Le cas échéant, doit se trouver après l’élément <Label> . Vous ne pouvez pas avoir à la fois <InsertAfter> et <InsertBefore>.

Importante

L’élément< InsertAfter> est disponible uniquement dans PowerPoint.

Type de complément : volet Office

Valide uniquement dans les schémas VersionOverrides suivants :

  • Volet De tâches 1.0

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

InsertBefore

Optional. Spécifie que l’onglet personnalisé doit être juste avant un onglet Office intégré spécifié. La valeur de l’élément est l’ID de l’onglet intégré, par TabHome exemple ou TabReview. La valeur de l’élément est l’ID de l’onglet intégré, par TabHome exemple ou TabReview. Pour obtenir la liste des onglets intégrés, voir OfficeTab. Le cas échéant, doit se trouver après l’élément <Label> . Vous ne pouvez pas avoir à la fois <InsertAfter> et <InsertBefore>.

Importante

L’élément <InsertBefore> est disponible uniquement dans PowerPoint.

Type de complément : volet Office

Valide uniquement dans les schémas VersionOverrides suivants :

  • Volet De tâches 1.0

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

Exemples

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.TabCustom">
    <Group id="Contoso.TabCustom1.group1">
       <!-- additional markup omitted -->
    </Group>
    <OfficeGroup id="Paragraph" />
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>

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.TabCustom">
    <Group id="Contoso.TabCustom2.group2">
        <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.Button2">
            <!-- information on the control omitted -->
        </Control>
        <OfficeControl id="Superscript" />
        <!-- other controls, as needed -->
    </Group>
    <Label resid="customTabLabel1" />
  </CustomTab>
</ExtensionPoint>