Group element
Represents a Group control that functions as a container for a group of elements.
Usage
<Group
SizeDefinition = "xs:string"
ApplicationModes = "xs:string"
CommandName = "xs:positiveInteger or xs:string">
child elements
</Group>
Attributes
| Attribute | Type | Required | Description |
|---|---|---|---|
| ApplicationModes |
xs:string |
No |
White space is valid and ignored. Maximum length: 250 characters. |
| CommandName |
xs:positiveInteger or xs:string |
No |
Associates the element with a Command. The value must be unique within the Ribbon XML document. Maximum length: 100 characters. |
| SizeDefinition |
xs:string |
No |
When specified, the value of SizeDefinition is constrained to one of the layout templates defined by the Ribbon framework. The maximum length is unbounded. |
Child elements
| Element | Description |
|---|---|
| Button |
May occur one or more times |
| CheckBox |
May occur one or more times |
| ComboBox |
May occur one or more times |
| ControlGroup |
May occur one or more times |
| DropDownButton |
May occur one or more times |
| DropDownColorPicker |
May occur one or more times |
| DropDownGallery |
May occur one or more times |
| FontControl |
May occur at most once |
| InRibbonGallery |
May occur one or more times |
| SizeDefinition |
May occur at most once |
| Spinner |
May occur one or more times |
| SplitButton |
May occur one or more times |
| SplitButtonGallery |
May occur one or more times |
| ToggleButton |
May occur one or more times |
Parent elements
| Element |
|---|
| Tab |
Remarks
Optional.
May occur one or more times for each Tab element.
Tab supports application modes.
The Ribbon markup is valid only when the child elements of Group correspond to the template specified for SizeDefinition.
Examples
The following code example illustrates the use of a custom template in a Group.
<Group CommandName="cmdCustomGroup1" SizeDefinition="CustomTemplate">
<Button CommandName="cmdCommand1" />
</Group>
Element information
- Minimum supported system: Windows 7
- Can be empty: No