PresetGeometry class

Office 2013 and later

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

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

C#
VB
C++
Copy
No code example is currently available or this language may not be supported.

[ISO/IEC 29500-1 1st Edition]

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>

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.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: