Partager via


Shape3DType Class

Apply 3D shape properties.When the object is serialized out as xml, its qualified name is a:sp3d.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Drawing.Shape3DType

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

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(BevelTop))> _
<ChildElementInfoAttribute(GetType(BevelBottom))> _
<ChildElementInfoAttribute(GetType(ExtrusionColor))> _
<ChildElementInfoAttribute(GetType(ContourColor))> _
<ChildElementInfoAttribute(GetType(ExtensionList))> _
Public Class Shape3DType _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As Shape3DType
[ChildElementInfoAttribute(typeof(BevelTop))]
[ChildElementInfoAttribute(typeof(BevelBottom))]
[ChildElementInfoAttribute(typeof(ExtrusionColor))]
[ChildElementInfoAttribute(typeof(ContourColor))]
[ChildElementInfoAttribute(typeof(ExtensionList))]
public class Shape3DType : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • BevelTop <a:bevelT>

  • BevelBottom <a:bevelB>

  • ExtrusionColor <a:extrusionClr>

  • ContourColor <a:contourClr>

  • ExtensionList <a:extLst>

[ISO/IEC 29500-1 1st Edition]

20.1.5.12 sp3d (Apply 3D shape properties)

This element defines the 3D properties associated with a particular shape in DrawingML. The 3D properties which can be applied to a shape are top and bottom bevels, a contour and an extrusion.

[Example: Consider the following example of an sp3d in DrawingML:

<a:sp3d extrusionH="165100" contourW="50800" prstMaterial="plastic">
<a:bevelT w="254000" h="254000"/>
<a:bevelB w="254000" h="254000"/>
<a:extrusionClr>
<a:srgbClr val="FF0000"/>
</a:extrusionClr>
<a:contourClr>
<a:schemeClr val="accent3"/>
</a:contourClr>
</a:sp3d>

In this example, we see an sp3d defined which contains information defining both a top and bottom bevel, along with an extrusion and contour on the shape. The following image illustrates a shape with the applied sp3d:

DocumentFormat.OpenXml.Drawing.Shape3DType-image00

end example]

Parent Elements

bodyPr (§21.1.2.1.1); effectStyle (§20.1.4.1.11); spPr (§21.2.2.197); spPr (§21.3.2.23); spPr (§21.4.3.7); spPr (§20.1.2.2.35); spPr (§20.2.2.6); spPr (§20.5.2.30); spPr (§19.3.1.44); txPr (§21.4.5.12)

Child Elements

Subclause

bevelB (Bottom Bevel)

§20.1.5.3

bevelT (Top Bevel)

§20.1.5.4

contourClr (Contour Color)

§20.1.5.6

extLst (Extension List)

§20.1.2.2.15

extrusionClr (Extrusion Color)

§20.1.5.7

Attributes

Description

contourW (Contour Width)

Defines the width of the contour on the shape.

[Example: Consider the following example of a contourW in use within the sp3d element:

<a:sp3d extrusionH="165100" contourW="50800"
prstMaterial="plastic">
<a:bevelT w="254000" h="254000"/>
<a:bevelB w="254000" h="254000"/>
<a:extrusionClr>
<a:srgbClr val="FF0000"/>
</a:extrusionClr>
<a:contourClr>
<a:schemeClr val="accent3"/>
</a:contourClr>
</a:sp3d>

In this example, we see a countourW defined as 50800. end example]

The possible values for this attribute are defined by the ST_PositiveCoordinate simple type (§20.1.10.42).

extrusionH (Extrusion Height)

Defines the height of the extrusion applied to the shape.

[Example: Consider the following example of an extrusionH in use within the sp3d element:

<a:sp3d extrusionH="165100" contourW="50800" prstMaterial="plastic">
<a:bevelT w="254000" h="254000"/>
<a:bevelB w="254000" h="254000"/>
<a:extrusionClr>
<a:srgbClr val="FF0000"/>
</a:extrusionClr>
<a:contourClr>
<a:schemeClr val="accent3"/>
</a:contourClr>
</a:sp3d>

In this example, we see a extrusionH defined as 165100. end example]

The possible values for this attribute are defined by the ST_PositiveCoordinate simple type (§20.1.10.42).

prstMaterial (Preset Material Type)

Defines the preset material which is combined with the lighting properties to give the final look and feel of a shape.

[Example: Consider the following example of a prstMaterial in use within the sp3d element:

<a:sp3d extrusionH="165100" contourW="50800"
prstMaterial="plastic">
<a:bevelT w="254000" h="254000"/>
<a:bevelB w="254000" h="254000"/>
<a:extrusionClr>
<a:srgbClr val="FF0000"/>
</a:extrusionClr>
<a:contourClr>
<a:schemeClr val="accent3"/>
</a:contourClr>
</a:sp3d>

In this example, we see a prstMaterial defined as plastic. end example]

The possible values for this attribute are defined by the ST_PresetMaterialType simple type (§20.1.10.50).

z (Shape Depth)

Defines the z coordinate for the 3D shape.

The possible values for this attribute are defined by the ST_Coordinate simple type (§20.1.10.16).

[Note: The W3C XML Schema definition of this element’s content model (CT_Shape3D) 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

Shape3DType Members

DocumentFormat.OpenXml.Drawing Namespace