[Table of Contents] [docx version]
PresentationML Reference Material - Table of Contents
This element specifies a group shape that represents many shapes grouped together. This shape is to be treated just as if it were a regular shape but instead of being described by a single geometry it is made up of all the shape geometries encompassed within it. Within a group shape each of the shapes that make up the group are specified just as they normally would. The idea behind grouping elements however is that a single transform can apply to many shapes at the same time.
[Example: Consider the following group shape.
<p:grpSp>
<p:nvGrpSpPr>
<p:cNvPr id="10" name="Group 9"/>
<p:cNvGrpSpPr/>
<p:nvPr/>
</p:nvGrpSpPr>
<p:grpSpPr>
<a:xfrm>
<a:off x="838200" y="990600"/>
<a:ext cx="2426208" cy="978408"/>
<a:chOff x="838200" y="990600"/>
<a:chExt cx="2426208" cy="978408"/>
</a:xfrm>
</p:grpSpPr>
<p:sp>
..
</p:sp>
<p:sp>
..
</p:sp>
<p:sp>
..
</p:sp>
</p:grpSp>
In the above example we see three shapes specified within a single group. These three shapes have their position and sizes specified just as they normally would within the shape tree. The generating application should apply the transformation after the bounding box for the group shape has been calculated. End example]
Parent Elements |
grpSp (§4.4.1.19); spTree (§4.4.1.42) |
Child Elements |
Subclause |
cxnSp (Connection Shape) |
§4.4.1.17 |
extLst (Extension List with Modification Flag) |
§4.2.4 |
graphicFrame (Graphic Frame) |
§4.4.1.18 |
grpSp (Group Shape) |
§4.4.1.19 |
grpSpPr (Group Shape Properties) |
§4.4.1.20 |
nvGrpSpPr (Non-Visual Properties for a Group Shape) |
§4.4.1.28 |
pic (Picture) |
§4.4.1.34 |
sp (Shape) |
§4.4.1.40 |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_GroupShape">
<sequence>
<element name="nvGrpSpPr" type="CT_GroupShapeNonVisual" minOccurs="1" maxOccurs="1"/>
<element name="grpSpPr" type="a:CT_GroupShapeProperties" minOccurs="1" maxOccurs="1"/>
<choice minOccurs="0" maxOccurs="unbounded">
<element name="sp" type="CT_Shape"/>
<element name="grpSp" type="CT_GroupShape"/>
<element name="graphicFrame" type="CT_GraphicalObjectFrame"/>
<element name="cxnSp" type="CT_Connector"/>
<element name="pic" type="CT_Picture"/>
</choice>
<element name="extLst" type="CT_ExtensionListModify" minOccurs="0" maxOccurs="1"/>
</sequence>
</complexType>