GroupShape Class

Group Shape.When the object is serialized out as xml, its qualified name is p:grpSp.

Namespace:  DocumentFormat.OpenXml.Presentation
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

public class GroupShape : GroupShapeType

The following table lists the possible child types:

  • NonVisualGroupShapeProperties <p:nvGrpSpPr>

  • GroupShapeProperties <p:grpSpPr>

  • Shape <p:sp>

  • GroupShape <p:grpSp>

  • GraphicFrame <p:graphicFrame>

  • ConnectionShape <p:cxnSp>

  • Picture <p:pic>

  • ContentPart <p:contentPart>

  • ExtensionListWithModification <p:extLst>


[ISO/IEC 29500-1 1st Edition]

19.3.1.22 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.

<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 (§19.3.1.22); spTree (§19.3.1.45)

Child Elements

Subclause

contentPart (Content Part)

§19.3.1.14

cxnSp (Connection Shape)

§19.3.1.19

extLst (Extension List with Modification Flag)

§19.3.1.20

graphicFrame (Graphic Frame)

§19.3.1.21

grpSp (Group Shape)

§19.3.1.22

grpSpPr (Group Shape Properties)

§19.3.1.23

nvGrpSpPr (Non-Visual Properties for a Group Shape)

§19.3.1.31

pic (Picture)

§19.3.1.37

sp (Shape)

§19.3.1.43

[Note: The W3C XML Schema definition of this element’s content model (CT_GroupShape) is located in §A.3. end note]

© ISO/IEC29500: 2008.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

ADD
Show:
© 2015 Microsoft