Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

GroupShapeProperties Class

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


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

public class GroupShapeProperties : OpenXmlCompositeElement

The following table lists the possible child types:

  • DocumentFormat.OpenXml.Drawing.TransformGroup <a:xfrm>

  • DocumentFormat.OpenXml.Drawing.NoFill <a:noFill>

  • DocumentFormat.OpenXml.Drawing.SolidFill <a:solidFill>

  • DocumentFormat.OpenXml.Drawing.GradientFill <a:gradFill>

  • DocumentFormat.OpenXml.Drawing.BlipFill <a:blipFill>

  • DocumentFormat.OpenXml.Drawing.PatternFill <a:pattFill>

  • DocumentFormat.OpenXml.Drawing.GroupFill <a:grpFill>

  • DocumentFormat.OpenXml.Drawing.EffectList <a:effectLst>

  • DocumentFormat.OpenXml.Drawing.EffectDag <a:effectDag>

  • DocumentFormat.OpenXml.Drawing.Scene3DType <a:scene3d>

  • DocumentFormat.OpenXml.Drawing.ExtensionList <a:extLst>

[ISO/IEC 29500-1 1st Edition] grpSpPr (Group Shape Properties)

This element specifies the properties that are to be common across all of the shapes within the corresponding group. If there are any conflicting properties within the group shape properties and the individual shape properties then the individual shape properties should take precedence.

Parent Elements

grpSp (§; spTree (§

Child Elements


blipFill (Picture Fill)


effectDag (Effect Container)


effectLst (Effect Container)


extLst (Extension List)


gradFill (Gradient Fill)


grpFill (Group Fill)


noFill (No Fill)


pattFill (Pattern Fill)


scene3d (3D Scene Properties)


solidFill (Solid Fill)


xfrm (2D Transform for Grouped Objects)




bwMode (Black and White Mode)

Namespace: .../drawingml/2006/main

Specifies that the group shape should be rendered using only black and white coloring. That is the coloring information for the group shape should be converted to either black or white when rendering the corresponding shapes.

No gray is to be used in rendering this image, only stark black and stark white.

[Note: This does not mean that the group shapes themselves are stored with only black and white color information. This attribute instead sets the rendering mode that the shapes use when rendering. end note]

The possible values for this attribute are defined by the ST_BlackWhiteMode simple type (§

[Note: The W3C XML Schema definition of this element’s content model (CT_GroupShapeProperties) is located in §A.4.1. 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.
© 2015 Microsoft