This documentation is archived and is not being maintained.

ShapeProperties Class

Defines the ShapeProperties Class.When the object is serialized out as xml, its qualified name is p:spPr.

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

public class ShapeProperties : OpenXmlCompositeElement

The following table lists the possible child types:

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

  • DocumentFormat.OpenXml.Drawing.CustomGeometry <a:custGeom>

  • DocumentFormat.OpenXml.Drawing.PresetGeometry <a:prstGeom>

  • 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.Outline <a:ln>

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

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

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

  • DocumentFormat.OpenXml.Drawing.Shape3DType <a:sp3d>

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

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

This element specifies the visual shape properties that can be applied to a shape. These properties include the shape fill, outline, geometry, effects, and 3D orientation.

Parent Elements

cxnSp (§; pic (§; sp (§

Child Elements


blipFill (Picture Fill)


custGeom (Custom Geometry)


effectDag (Effect Container)


effectLst (Effect Container)


extLst (Extension List)


gradFill (Gradient Fill)


grpFill (Group Fill)


ln (Outline)


noFill (No Fill)


pattFill (Pattern Fill)


prstGeom (Preset geometry)


scene3d (3D Scene Properties)


solidFill (Solid Fill)


sp3d (Apply 3D shape properties)


xfrm (2D Transform for Individual Objects)




bwMode (Black and White Mode)

Namespace: .../drawingml/2006/main

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

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

[Note: This does not mean that the picture itself that is stored within the file is necessarily a black and white picture. This attribute instead sets the rendering mode that the picture has applied to 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_ShapeProperties) 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.