Export (0) Print
Expand All

Group Element (Ribbon)

Defines a group of controls.

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

Attribute

Description

Command

Optional. The value is used to enable or disable the controls in the group. If the Command attribute is present and has a value, the ribbon polls to see if the command is disabled. If it is disabled, the ribbon does not poll for any commands that are associated with the controls in the group; the controls are also effectively disabled.

Description

Optional. A description of the group.

Id

Required. A string that identifies the group, such as "Ribbon.DocLibListForm.Edit.Clipboard".

Image32by32Popup

Optional. A server-relative URL to a file that contains a 32-by-32-pixel image to be used to represent the group, such as “/_layouts/1033/images/formatmap32x32.png”.

Image32by32PopupClass

Optional. The name of a CSS class selector to be applied to the image.

Image32by32PopupLeft

Optional. A negative integer that represents an offset for the left edge of the image. Use this attribute when the Image32by32Popup attribute points to an image file that contains images for many icons. The value of the Image32by32PopupLeft attribute is used to set the CSS left attribute for the inline style of an HTML img tag.

Image32by32PopupTop

Optional. A negative integer that represents an offset for the top edge of the image. Use this attribute when the Image32by32Popup attribute points to an image file that contains images for many icons. The value of the Image32by32PopupTop attribute is used to set the CSS top attribute for the inline style of an HTML img tag.

Sequence

Optional. An integer that specifies the order of placement among sibling XML nodes.

Template

Optional. A string that corresponds to the Id attribute of a GroupTemplate element.

Title

Optional. The text that is displayed as the group’s title on the ribbon and in the tooltip.

Minimum: 0

Maximum: unbounded

The following XML fragment defines a group that contains two buttons.

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

Community Additions

ADD
Show:
© 2014 Microsoft