Share via


CloseShapePath Class

Close Shape Path.When the object is serialized out as xml, its qualified name is a:close.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Drawing.CloseShapePath

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

Syntax

'Declaration
Public Class CloseShapePath _
    Inherits OpenXmlLeafElement
'Usage
Dim instance As CloseShapePath
public class CloseShapePath : OpenXmlLeafElement

Remarks

[ISO/IEC 29500-1 1st Edition]

20.1.9.6 close (Close Shape Path)

This element specifies the ending of a series of lines and curves in the creation path of a custom geometric shape. When this element is encountered, the generating application should consider the corresponding path closed. That is, any further lines or curves that follow this element should be ignored.

[Note: A path can be specified and not closed. A path such as this cannot however have any fill associated with it as it has not been considered a closed geometric path. end note]

[Example: Consider the following DrawingML.

<a:custGeom>
<a:pathLst>
<a:path w="2824222" h="590309">
<a:moveTo>
<a:pt x="0" y="428263"/>
</a:moveTo>
      <a:lnTo>
<a:pt x="1620455" y="590309"/>
</a:lnTo>
      <a:lnTo>
<a:pt x="2824222" y="173620"/>
</a:lnTo>
      <a:lnTo>
<a:pt x="1562582" y="0"/>
</a:lnTo>
      <a:close/>
</a:path>
</a:pathLst>
</a:custGeom>

In the above example there is specified a four sided geometric shape that has all straight sides. While we only see three lines being drawn via the lnTo element there are actually four sides because the last point of (x=1562585, y=0) is connected to the first point in the creation path via a lnTo element. end example]

[Note: When the last point in the creation path does not meet with the first point in the creation path the generating application should connect the last point with the first via a straight line, thus creating a closed shape geometry. end note]

Parent Elements

path (§20.1.9.15)

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

CloseShapePath Members

DocumentFormat.OpenXml.Drawing Namespace