PresetGeometry Class

Preset geometry.When the object is serialized out as xml, its qualified name is a:prstGeom.

Inheritance Hierarchy

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

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

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(AdjustValueList))> _
Public Class PresetGeometry _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As PresetGeometry
[ChildElementInfoAttribute(typeof(AdjustValueList))]
public class PresetGeometry : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • AdjustValueList <a:avLst>

[ISO/IEC 29500-1 1st Edition]

20.1.9.18 prstGeom (Preset geometry)

This element specifies when a preset geometric shape should be used instead of a custom geometric shape. The generating application should be able to render all preset geometries enumerated in the ST_ShapeType list.

[Example: Consider the scenario when a user does not wish to specify all the lines and curves that make up the desired shape but instead chooses to use a preset geometry. The following DrawingML would specify such a case.

<p:sp>
<p:nvSpPr>
<p:cNvPr id="4" name="My Preset Shape"/>
<p:cNvSpPr/>
<p:nvPr/>
</p:nvSpPr>
  <p:spPr>
<a:xfrm>
<a:off x="1981200" y="533400"/>
<a:ext cx="1143000" cy="1066800"/>
</a:xfrm>
<a:prstGeom prst="heart">
</a:prstGeom>
</p:spPr>
</p:sp>

DocumentFormat.OpenXml.Drawing.PresetGeometry-imag

The output shape rendered by this DrawingML is shown above. end example]

Parent Elements

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)

Child Elements

Subclause

avLst (List of Shape Adjust Values)

§20.1.9.5

Attributes

Description

prst (Preset Shape)

Specifies the preset geometry that is used for this shape. This preset can have any of the values in the enumerated list for ST_ShapeType. This attribute is required in order for a preset geometry to be rendered.

[Example: Consider the sample DrawingML below.

<p:sp>
<p:nvSpPr>
<p:cNvPr id="4" name="Sun 3"/>
<p:cNvSpPr/>
<p:nvPr/>
</p:nvSpPr>
  <p:spPr>
<a:xfrm>
<a:off x="1981200" y="533400"/>
<a:ext cx="1143000" cy="1066800"/>
</a:xfrm>
<a:prstGeom prst="sun">
</a:prstGeom>
</p:spPr>
</p:sp>

In the above example a preset geometry has been used to define a shape. The shape utilized here is the sun shape. end example]

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

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

PresetGeometry Members

DocumentFormat.OpenXml.Drawing Namespace