<Gallery> (RibbonDiffXml)
Specifies a control that displays a collection of related controls in the Ribbon. If there are too many items in the gallery, an expand arrow is provided to display the rest of the collection in a pane.
<Gallery Command="String" CommandPreview="String" CommandRevert="String" ElementDimensions= ["Size16by16" | "Size32by32" | "Size48by48" | "Size64by48" | "Size72by96" | "Size96by72" | "Size96by96" | "Size128by128" | "Size190by30" | "Size190by40" | "Size190by50" | "Size190by60"] Id="String" QueryCommand="String" Sequence="Integer" Width="Integer" > <GalleryButton /> </Gallery>
The following table lists the attributes, child elements, and parent elements.
Attributes
| Attribute | Description | Type | Usage |
|---|---|---|---|
| Command | Specifies the ID of the ribbon command for this control. | String | Optional |
| CommandPreview | Specifies the ID of the ribbon command to execute when the cursor hovers over the control before it is selected. | String | Optional |
| CommandRevert | Specifies the ID of the ribbon command to execute when the user selects undo. | String | Optional |
| ElementDimensions | Controls the size of a Gallery or GalleryButton element. Valid values:
| Enumeration | Required |
| Id | Specifies a unique identifier for the definition of a ribbon element. The strongly recommended naming convention is to use a period to separate consistent components like so: [solution identifier].[entity].[ribbon].[function].[element name]. For example: MyISV.account.form.SendToOtherSystem.Button. | String | Required |
| QueryCommand | Specifies the name of the command to execute when polling for state information. | String | Optional |
| Sequence | Specify the location of the ribbon modification by setting the Sequence value higher or lower than existing ribbon elements. | Integer | Optional |
| Width | Specifies a desired width for the control in pixels. | Integer | Required |
Child Elements
| Element | Description |
|---|---|
| Specifies a button control within a gallery element. |
Parent Elements
| Element | Description |
|---|---|
| Specifies the visible Ribbon elements to be included within a CustomAction element. | |
| Specifies a section used to divide a menu. A menu section can have a title and contain controls. |
| XPath |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Gallery | //RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/MenuSection/Gallery | //Menu/MenuSection/Gallery |
| Schema Name | GalleryType |
| Validation File | RibbonWSS.xsd |
| Can be Empty | No |
Send comments about this topic to Microsoft.
© 2012 Microsoft Corporation. All rights reserved.
