Élément Group

  • Article

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.

Associé à ces ensembles de conditions requises :

Attributs

Attribut Obligatoire Description
id Oui ID unique du groupe.

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

Élément Obligatoire Description
Label Oui Étiquette d’un groupe.
Icon Oui Image d’un groupe. Non pris en charge dans les compléments Outlook.
Contrôle Non Représente un objet Control. Peut être égal à zéro ou plus.
OfficeControl Non Représente l’un des contrôles Office intégrés. Peut être égal à zéro ou plus. Pris en charge uniquement dans les compléments PowerPoint.
OverriddenByRibbonApi Non Spécifie si le groupe doit apparaître sur les combinaisons d’applications et de plateformes qui prennent en charge les onglets contextuels personnalisés. Non pris en charge dans les compléments Outlook.

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

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.

Remarque

Cet élément enfant n’est pas pris en charge dans les compléments Outlook.

Contrôle

Facultatif, mais s’il n’est pas présent, il doit y avoir au moins un <Contrôle Office>. Pour plus d’informations sur les types de contrôles pris en charge, consultez l’élément Control . L’ordre des <commandes Control> et <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 des <commandes Control> et <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.

Associé à ces ensembles de conditions requises :

Remarque

Cet élément enfant est pris en charge uniquement dans les compléments PowerPoint.

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

Remarque

Cet élément enfant n’est pas pris en charge dans les compléments Outlook.

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