É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, soit à l’un des onglets Office intégrés, soit à votre onglet personnalisé. Utilisez l’élément <CustomTab> pour ajouter un onglet personnalisé au ruban. Sur les onglets personnalisés, le complément peut comporter des groupes personnalisés ou prédéfinis. Les compléments sont limités à un onglet personnalisé.

Type de complément : Volet Office, Courrier

Valide uniquement dans ces schémas VersionOverrides :

• 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. Voir Éléments enfants.

Attributs

Attribut id

Obligatoire. Identificateur unique de l’onglet personnalisé. Il s’agit d’une chaîne de caractères ne dépassant pas 125 caractères. Celui-ci doit être unique dans le manifeste.

Éléments enfants

Groupe

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 du groupe> et du< groupeOfficeGroup> dans le manifeste doit être l’ordre dans lequel vous souhaitez qu’ils apparaissent dans l’onglet personnalisé.< Ils peuvent être entremêlés s’il y a plusieurs éléments, mais tous doivent être 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 de groupe> . Représente un groupe de contrôle Office intégré. L’attribut id spécifie l’ID du groupe Office intégré. Pour trouver l’ID d’un groupe intégré, voir Rechercher les ID des contrôles et des groupes de contrôles. L’ordre du groupe> et du< groupeOfficeGroup> dans le manifeste doit être l’ordre dans lequel vous souhaitez qu’ils apparaissent dans l’onglet personnalisé.< Ils peuvent être entremêlés s’il y a plusieurs éléments, mais tous doivent être au-dessus de l’élément <Label>.

Type de complément : volet Office

Valide uniquement dans ces schémas VersionOverrides :

• 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> de l’élément <ShortStrings> de l’élément Resources .

Type de complément : Volet Office, Courrier

Valide uniquement dans ces schémas VersionOverrides :

• 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

Facultatif. 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é, tel que TabHome ou TabReview. Pour obtenir la liste des onglets intégrés, voir OfficeTab. S’il est présent, doit se trouver après l’élément <Label> . Vous ne pouvez pas avoir <InsertAfter> et <InsertBefore>.

Type de complément : volet Office

Valide uniquement dans ces schémas VersionOverrides :

• 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

Facultatif. Spécifie que l’onglet personnalisé doit se trouver immédiatement avant un onglet Office intégré spécifié. La valeur de l’élément est l’ID de l’onglet intégré, tel que TabHome ou TabReview. La valeur de l’élément est l’ID de l’onglet intégré, tel que TabHome ou TabReview. Pour obtenir la liste des onglets intégrés, voir OfficeTab. S’il est présent, doit se trouver après l’élément <Label> . Vous ne pouvez pas avoir <InsertAfter> et <InsertBefore>.

Type de complément : volet Office

Valide uniquement dans ces schémas VersionOverrides :

• 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 apparaître juste après un groupe personnalisé.

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <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 Exposant Office à un groupe personnalisé et le positionne pour apparaître juste après un bouton personnalisé.

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <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>