Group, élément (Ribbon)

Article
09/24/2014

Dernière modification : mercredi 13 octobre 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences

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

Attributs

Attribut	Description
Command	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 de serveur vers un fichier qui contient une image de 32 pixels de côté destinée à représenter le groupe, telle que « /_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.
Template	Facultatif. Chaîne qui correspond à l’attribut Id d’un élément GroupTemplate.
Title	Facultatif. Texte qui apparaît comme titre du groupe sur le Ruban et dans l’info-bulle.

Éléments enfants

Controls

Éléments parents

CommandUIDefinition

Groups

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

Tâches

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

Partager via