Export (0) Print
Expand All

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

AttributeTypeRequiredDescription

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

ElementDescription

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 emptyNo

See also

Customizing a Ribbon Through Size Definitions and Scaling Policies
Group control
SetModes

 

 

Community Additions

ADD
Show:
© 2014 Microsoft