ShapeProperties Class

Shape Properties.When the object is serialized out as xml, its qualified name is pic:spPr.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Drawing.Pictures.ShapeProperties

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

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(Outline))> _
<ChildElementInfoAttribute(GetType(Transform2D))> _
<ChildElementInfoAttribute(GetType(CustomGeometry))> _
<ChildElementInfoAttribute(GetType(PresetGeometry))> _
<ChildElementInfoAttribute(GetType(NoFill))> _
<ChildElementInfoAttribute(GetType(SolidFill))> _
<ChildElementInfoAttribute(GetType(GradientFill))> _
<ChildElementInfoAttribute(GetType(BlipFill))> _
<ChildElementInfoAttribute(GetType(PatternFill))> _
<ChildElementInfoAttribute(GetType(GroupFill))> _
<ChildElementInfoAttribute(GetType(EffectList))> _
<ChildElementInfoAttribute(GetType(EffectDag))> _
<ChildElementInfoAttribute(GetType(Scene3DType))> _
<ChildElementInfoAttribute(GetType(Shape3DType))> _
<ChildElementInfoAttribute(GetType(ShapePropertiesExtensionList))> _
Public Class ShapeProperties _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As ShapeProperties
[ChildElementInfoAttribute(typeof(Outline))]
[ChildElementInfoAttribute(typeof(Transform2D))]
[ChildElementInfoAttribute(typeof(CustomGeometry))]
[ChildElementInfoAttribute(typeof(PresetGeometry))]
[ChildElementInfoAttribute(typeof(NoFill))]
[ChildElementInfoAttribute(typeof(SolidFill))]
[ChildElementInfoAttribute(typeof(GradientFill))]
[ChildElementInfoAttribute(typeof(BlipFill))]
[ChildElementInfoAttribute(typeof(PatternFill))]
[ChildElementInfoAttribute(typeof(GroupFill))]
[ChildElementInfoAttribute(typeof(EffectList))]
[ChildElementInfoAttribute(typeof(EffectDag))]
[ChildElementInfoAttribute(typeof(Scene3DType))]
[ChildElementInfoAttribute(typeof(Shape3DType))]
[ChildElementInfoAttribute(typeof(ShapePropertiesExtensionList))]
public class ShapeProperties : OpenXmlCompositeElement

Remarks

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]

20.2.2.6 spPr (Shape Properties)

This element specifies the visual shape properties that can be applied to a picture. These are the same properties that are allowed to describe the visual properties of a shape but are used here to describe the visual appearance of a picture within a document. This allows for a picture to have both the properties of a shape as well as picture specific properties that are allowed under the pic element.

Parent Elements

pic (§20.2.2.5)

Child Elements

Subclause

blipFill (Picture Fill)

§20.1.8.14

custGeom (Custom Geometry)

§20.1.9.8

effectDag (Effect Container)

§20.1.8.25

effectLst (Effect Container)

§20.1.8.26

extLst (Extension List)

§20.1.2.2.15

gradFill (Gradient Fill)

§20.1.8.33

grpFill (Group Fill)

§20.1.8.35

ln (Outline)

§20.1.2.2.24

noFill (No Fill)

§20.1.8.44

pattFill (Pattern Fill)

§20.1.8.47

prstGeom (Preset geometry)

§20.1.9.18

scene3d (3D Scene Properties)

§20.1.4.1.26

solidFill (Solid Fill)

§20.1.8.54

sp3d (Apply 3D shape properties)

§20.1.5.12

xfrm (2D Transform for Individual Objects)

§20.1.7.6

Attributes

Description

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 (§20.1.10.10).

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

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

ShapeProperties Members

DocumentFormat.OpenXml.Drawing.Pictures Namespace