ShapeTree Class

Defines the ShapeTree Class.When the object is serialized out as xml, its qualified name is dsp:spTree.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Office.Drawing.GroupShapeType
        DocumentFormat.OpenXml.Office.Drawing.ShapeTree

Namespace:  DocumentFormat.OpenXml.Office.Drawing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
Public Class ShapeTree _
    Inherits GroupShapeType
'Usage
Dim instance As ShapeTree
public class ShapeTree : GroupShapeType

Remarks

The following table lists the possible child types:

  • GroupShapeNonVisualProperties <dsp:nvGrpSpPr>

  • GroupShapeProperties <dsp:grpSpPr>

  • Shape <dsp:sp>

  • GroupShape <dsp:grpSp>

  • OfficeArtExtensionList <dsp:extLst>

2.5.53 CT_GroupShape

Target namespace: https://schemas.microsoft.com/office/drawing/2008/diagram

Referenced by: CT_GroupShape, CT_Drawing

This element specifies a group shape that represents one or more 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 the group of shapes as though it were a single shape.

Child Elements:

nvGrpSpPr : A CT_GroupShapeNonVisual element that specifies the non-visual properties of this group shape.

grpSpPr : A CT_GroupShapeProperties [ISO/IEC-29500-1] section A.4.1 element that specifies group shape properties.

sp : A CT_Shape element that specifies a shape that is a child of this group.

grpSp : A CT_GroupShape element that specifies a group shape that is a child of this group.

extLst : A CT_OfficeArtExtensionList [ISO/IEC-29500-1] section A.4.1 element that allows future extensions to the group shape.

The following W3C XML Schema ([XMLSCHEMA1] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_GroupShape">

<xsd:sequence>

<xsd:element name="nvGrpSpPr" type="CT_GroupShapeNonVisual" minOccurs="1" maxOccurs="1"/>

<xsd:element name="grpSpPr" type="a:CT_GroupShapeProperties" minOccurs="1" maxOccurs="1"/>

<xsd:choice minOccurs="0" maxOccurs="unbounded">

<xsd:element name="sp" type="CT_Shape"/>

<xsd:element name="grpSp" type="CT_GroupShape"/>

</xsd:choice>

<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>

</xsd:sequence>

</xsd:complexType>

See section 5.8 for the full W3C XML Schema ([XMLSCHEMA1] section 2.1).

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.

See Also

Reference

ShapeTree Members

DocumentFormat.OpenXml.Office.Drawing Namespace