Élément Group (ruban serveur)

Article
04/08/2023

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

Définit un groupe de contrôles.

<Group
  Command="Text"
  Description="Text"
  Id="Text"
  Image32by32Popup="Url"
  Image32by32PopupClass="CSS Class Selector"
  Image32by32PopupLeft="Negative Integer"
  Image32by32PopupTop="Negative Integer"
  Sequence="Integer"
  Template="Text"
  Title="Text"
/>

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut	Description
Commande	Facultatif. Valeur permettant d’activer ou de désactiver les contrôles dans le groupe. Si l’attribut Command est présent et qu’il possède une valeur, le Ruban effectue une interrogation pour déterminer si la commande est désactivée. Si elle est désactivée, le Ruban n’effectue pas d’autres interrogations pour les commandes associées aux contrôles dans le groupe ; les contrôles sont en fait également désactivés.
Description	Facultatif. Description du groupe.
Id	Obligatoire. Chaîne qui identifie le groupe, telle que « Ribbon.DocLibListForm.Edit.Clipboard ».
Image32by32Popup	Facultatif. URL relative du serveur vers un fichier qui contient une image de 32 x 32 pixels à utiliser pour représenter le groupe, par exemple « /_layouts/1033/images/formatmap32x32.png ».
Image32by32PopupClass	Facultatif. Nom d’un sélecteur de classe CSS à appliquer à l’image.
Image32by32PopupLeft	Facultatif. Entier négatif qui représente un décalage pour le bord gauche de l’image. Utilisez cet attribut lorsque l’attribut Image32by32Popup pointe vers un fichier image qui contient des images de nombreuses icônes. La valeur de l’attribut Image32by32PopupLeft permet de définir l’attribut CSS left pour le style intraligne d’une balise HTML img.
Image32by32PopupTop	Facultatif. Entier négatif qui représente un décalage pour le bord supérieur de l’image. Utilisez cet attribut lorsque l’attribut Image32by32Popup pointe vers un fichier image qui contient des images de nombreuses icônes. La valeur de l’attribut Image32by32PopupTop permet de définir l’attribut CSS top pour le style intraligne d’une balise HTML img.
Sequence	Facultatif. Entier qui spécifie l’ordre d’emplacement dans les nœuds XML frères.
Modèle	Facultatif. Chaîne qui correspond à l’attribut Id d’un élément GroupTemplate.
Titre	Facultatif. Texte affiché en tant que titre du groupe sur le ruban et dans l’info-bulle.

Éléments enfants

Controls

Éléments parents

Occurrences

Minimum : 0
Maximum : pas de limite

Exemple

Le fragment XML suivant définit un groupe qui contient deux boutons.

<Group
  Id="Ribbon.WikiPageTab.CustomGroup"
  Sequence="55"
  Description="Custom Group"
  Title="Custom"
  Command="EnableCustomGroup"
  Template="Ribbon.Templates.Flexible2">
  <Controls Id="Ribbon.WikiPageTab.CustomGroup.Controls">
    <Button
      Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupHello"
      Command="CustomGroupHelloWorld"
      Image16by16="/_layouts/images/FILMSTRP.GIF"
      Image32by32="/_layouts/images/PPEOPLE.GIF"
      LabelText="Hello, World"
      TemplateAlias="o2"
      Sequence="15" />
    <Button
      Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupGoodbye"
      Command="CustomGroupGoodbyeWorld"
      Image16by16="/_layouts/images/FILMSTRP.GIF"
      Image32by32="/_layouts/images/PPEOPLE.GIF"
      LabelText="Good-bye, World"
      TemplateAlias="o2"
      Sequence="18" />
  </Controls>
</Group>

Voir aussi

Procédure pas à pas : ajout d’un groupe au Ruban serveur

Partager via