Élément Group

Définit un groupe de contrôles d’interface utilisateur dans un onglet. Sous les onglets personnalisés, le complément peut créer plusieurs groupes. 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

Attributs

Attribut id

Obligatoire. Identificateur unique du groupe. Il s’agit d’une chaîne avec un maximum de 125 caractères. Cela doit être unique dans tous les éléments Group du manifeste.

Éléments enfants

Étiquette

Obligatoire. Libellé du groupe. 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.

Info-bulle

Type de complément : messagerie

Valide uniquement dans les schémas VersionOverrides suivants :

• 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

Optional. Info-bulle du groupe. 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> . L’élément <String> est un enfant de l’élément <LongStrings> , qui est un enfant de l’élément Resources .

Icône

Obligatoire. Si un onglet contient un grand nombre de groupes et que la fenêtre du programme est redimensionnée, l’image spécifiée peut s’afficher à la place.

Contrôle

Facultatif, mais s’il n’est pas présent, il doit y avoir au moins un <OfficeControl>. Pour plus d’informations sur les types de contrôles pris en charge, consultez l’élément Control . L’ordre de <Control> et <d’OfficeControl> dans le manifeste est interchangeable et peut être entremêlé s’il existe plusieurs éléments, mais tous doivent se trouver sous l’élément <Icon> .

<Group id="Contoso.CustomTab1.group1">
    <Label resid="CustomTabGroupLabel"/>
    <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 -->
    </Control>
    <!-- other controls, as needed -->
</Group>

OfficeControl

Facultatif, mais s’il n’est pas présent, il doit y avoir au moins un <contrôle>. Incluez un ou plusieurs contrôles Office intégrés dans le groupe avec <des éléments OfficeControl> . L’attribut id spécifie l’ID du contrôle Office intégré. Pour trouver l’ID d’un contrôle, consultez Rechercher les ID des contrôles et des groupes de contrôles. L’ordre de <Control> et <d’OfficeControl> dans le manifeste est interchangeable et peut être entremêlé s’il existe plusieurs éléments, mais tous doivent se trouver sous l’élément <Icon> .

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

<Group id="Contoso.CustomTab2.group2">
    <Label resid="CustomTabGroupLabel"/>
    <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 -->
    </Control>
    <OfficeControl id="Superscript" />
    <!-- other controls, as needed -->
</Group>

OverriddenByRibbonApi

Facultatif (booléen). Spécifie si le <groupe> sera masqué sur les combinaisons d’applications et de plateformes qui prennent en charge une API qui installe un onglet contextuel personnalisé sur le ruban au moment de l’exécution. La valeur par défaut, si elle n’est pas présente, est false. Si elle est utilisée, <OverriddenByRibbonApi> doit être le premier enfant de <Group>. Pour plus d’informations, consultez OverriddenByRibbonApi.

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <CustomTab id="Contoso.CustomTab">
    <Group id="Contoso.CustomTab.group1">
      <OverriddenByRibbonApi>true</OverriddenByRibbonApi>
      <!-- other child elements of the group -->
    </Group>
    <Label resid="customTabLabel"/>
  </CustomTab>
</ExtensionPoint>