Compartir a través de

Elemento Group (cinta de opciones del servidor)

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Define un grupo de controles.

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

Elementos y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción
Command
Opcional. El valor se usa para habilitar o deshabilitar los controles del grupo. Si el atributo Command está presente y tiene un valor, la cinta de opciones realiza un sondeo para averiguar si el comando está deshabilitado. Si lo está, la cinta de opciones no realiza el sondeo de ningún otro comando asociado con los controles del grupo; los controles también estarán deshabilitados de manera eficaz.
Descripción
Opcional. Una descripción del grupo.
Id
Necesario. Una cadena que identifica el grupo, como "Ribbon.DocLibListForm.Edit.Clipboard".
Image32by32Popup
Opcional. Dirección URL relativa al servidor a un archivo que contiene una imagen de 32 por 32 píxeles que se usará para representar el grupo, como "/_layouts/1033/images/formatmap32x32.png".
Image32by32PopupClass
Opcional. Nombre de un selector de clases CSS que se aplicará a la imagen.
Image32by32PopupLeft
Opcional. Entero negativo que representa un desplazamiento del borde izquierdo de la imagen. Use este atributo cuando el atributo Image32by32Popup señale a un archivo de imagen que contenga imágenes de varios iconos. El valor del atributo Image32by32PopupLeft se usa para establecer el atributo left de CSS para el estilo en línea de una etiqueta HTML img.
Image32by32PopupTop
Opcional. Entero negativo que representa un desplazamiento del borde superior de la imagen. Use este atributo cuando el atributo Image32by32Popup señale a un archivo de imagen que contenga imágenes de varios iconos. El valor del atributo Image32by32PopupTop se usa para establecer el atributo top de CSS para el estilo en línea de una etiqueta HTML img.
Sequence
Opcional. Entero que especifica el orden de colocación entre nodos XML del mismo nivel.
Plantilla
Opcional. Una cadena que corresponde al atributo Id de un elemento GroupTemplate.
Title
Opcional. Texto que se muestra como título del grupo en la cinta de opciones y en la información sobre herramientas.

Elementos secundarios

Elementos principales

Repeticiones

  • Mínimo: 0
  • Máximo: sin límite

Ejemplo

En el siguiente fragmento XML se define un grupo que contiene dos botones.

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

Vea también

  • Last updated on