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	(xs:string) A string that contains a comma-separated list of integers between 0 and 31. White space is valid and ignored. Maximum length: 250 characters.
CommandName	xs:positiveInteger or xs:string	No	Associates the element with a Command. (xs:positiveInteger or xs:string) A string, an integer value between 2 and 59999, inclusive, or a hexadecimal value between 0x2 and 0xea5f, inclusive. 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. (xs:string) Any sequence of zero or more characters. 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

See also

Customizing a Ribbon Through Size Definitions and Scaling Policies

Group control

SetModes