Élément CustomTab

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

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 :

• AddinCommands 1.1
• AddinCommands 1.3. Requis par certains éléments enfants. Consultez Éléments enfants.

Attributs

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

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

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 :

• AddinCommands 1.3

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 :

• AddinCommands 1.1

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

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 :

• AddinCommands 1.3

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

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 :

• AddinCommands 1.3

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>