Edit

Share via

Gallery element (Server Ribbon)

  • Article

Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Defines a gallery.

<Gallery
  Command="Text"
  CommandPreview="Text"
  CommandRevert="Text"
  ElementDimensions="Size16by16 | Size32by32 | Size48by48 | Size72by96 | Size96by72 | Size96by96 | Size128by128 | Size190by30 | Size190by40 | Size190by50 | Size190by60"
  Id="Text"
  QueryCommand="Text"
  Sequence="Integer"
  Width="Integer"
/>

Elements and attributes

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
Command
Optional. The name of the command to execute when the control is selected. If the control is in a CommandUIDefinition element, the value of the Command attribute of the control should be the same as the value of the Command attribute of a corresponding CommandUIHandler element.
CommandPreview
Optional. The name of the command to execute for previewing a selection.
CommandRevert
Optional. The name of the command to execute to return to the state that existed before previewing a selection.
ElementDimensions
Required. An enumeration value that specifies the dimensions of rectangular child elements. Dimensions are in pixels and are in the format "width by height".
Size16by16
Size32by32
Size48by48
Size72by96
Size96by72
Size96by96
Size128by128
Size190by30
Size190by40
Size190by50
Size190by60
Id
Required. A string that identifies the element, such as "GadgetsGallery".
QueryCommand
Optional. The name of the command to execute when polling for state information.
Sequence
Optional. An integer that specifies the order of placement among sibling XML nodes.
Width
Required. The width of the gallery in pixels.

Child elements

Parent elements

Occurrences

  • Minimum: 1
  • Maximum: 1

Remarks

A gallery is a graphically rich list box. The items in a gallery are usually mutually exclusive choices, and the result of a choice is visually previewed either by an image or by a rendered HTML fragment.