GroupShape Class
Group Shape.When the object is serialized out as xml, its qualified name is xdr:grpSp.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlCompositeElement
DocumentFormat.OpenXml.Drawing.Spreadsheet.GroupShape
Namespace: DocumentFormat.OpenXml.Drawing.Spreadsheet
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
<ChildElementInfoAttribute(GetType(GraphicFrame))> _
<ChildElementInfoAttribute(GetType(NonVisualGroupShapeProperties))> _
<ChildElementInfoAttribute(GetType(GroupShapeProperties))> _
<ChildElementInfoAttribute(GetType(Shape))> _
<ChildElementInfoAttribute(GetType(GroupShape))> _
<ChildElementInfoAttribute(GetType(ConnectionShape))> _
<ChildElementInfoAttribute(GetType(Picture))> _
<ChildElementInfoAttribute(GetType(ContentPart), FileFormatVersions.Office2010)> _
Public Class GroupShape _
Inherits OpenXmlCompositeElement
'Usage
Dim instance As GroupShape
[ChildElementInfoAttribute(typeof(GraphicFrame))]
[ChildElementInfoAttribute(typeof(NonVisualGroupShapeProperties))]
[ChildElementInfoAttribute(typeof(GroupShapeProperties))]
[ChildElementInfoAttribute(typeof(Shape))]
[ChildElementInfoAttribute(typeof(GroupShape))]
[ChildElementInfoAttribute(typeof(ConnectionShape))]
[ChildElementInfoAttribute(typeof(Picture))]
[ChildElementInfoAttribute(typeof(ContentPart), FileFormatVersions.Office2010)]
public class GroupShape : OpenXmlCompositeElement
Remarks
The following table lists the possible child types:
NonVisualGroupShapeProperties <xdr:nvGrpSpPr>
GroupShapeProperties <xdr:grpSpPr>
Shape <xdr:sp>
GroupShape <xdr:grpSp>
GraphicFrame <xdr:graphicFrame>
ConnectionShape <xdr:cxnSp>
Picture <xdr:pic>
DocumentFormat.OpenXml.Office2010.Excel.Drawing.ContentPart <xdr14:contentPart>
[ISO/IEC 29500-1 1st Edition]
20.5.2.17 grpSp (Group Shape)
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.
<xdr:grpSp>
<xdr:nvGrpSpPr>
<xdr:cNvPr id="10" name="Group 9"/>
<xdr:cNvGrpSpPr/>
<xdr:nvPr/>
</xdr:nvGrpSpPr>
<xdr: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>
</xdr:grpSpPr>
<xdr:sp>
..
</xdr:sp>
<xdr:sp>
..
</xdr:sp>
<xdr:sp>
..
</xdr:sp>
</xdr: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 |
|---|
absoluteAnchor (§20.5.2.1); grpSp (§20.5.2.17); oneCellAnchor (§20.5.2.24); twoCellAnchor (§20.5.2.33) |
Child Elements |
Subclause |
|---|---|
cxnSp (Connection Shape) |
§20.5.2.13 |
graphicFrame (Graphic Frame) |
§20.5.2.16 |
grpSp (Group Shape) |
§20.5.2.17 |
grpSpPr (Group Shape Properties) |
§20.5.2.18 |
nvGrpSpPr (Non-Visual Properties for a Group Shape) |
§20.5.2.21 |
pic (Picture) |
§20.5.2.25 |
sp (Shape) |
§20.5.2.29 |
[Note: The W3C XML Schema definition of this element’s content model (CT_GroupShape) is located in §A.4.5. end note]
© ISO/IEC29500: 2008.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.