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:
.gif "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.