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