Share via


PathList Class

List of Shape Paths.When the object is serialized out as xml, its qualified name is a:pathLst.

Inheritance Hierarchy

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

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

Syntax

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

Remarks

The following table lists the possible child types:

  • Path <a:path>

[ISO/IEC 29500-1 1st Edition]

20.1.9.16 pathLst (List of Shape Paths)

This element specifies the entire path that is to make up a single geometric shape. The pathLst can consist of many individual paths within it.

[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: A geometry with multiple paths within it should be treated visually as if each path were a distinct shape. That is each creation path has its first point and last point joined to form a closed shape. However, the generating application should then connect the last point to the first point of the new shape. If a close element is encountered at the end of the previous creation path then this joining line should not be rendered by the generating application. The rendering should resume with the first line or curve on the new creation path. end note]

Parent Elements

custGeom (§20.1.9.8)

Child Elements

Subclause

path (Shape Path)

§20.1.9.15

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

PathList Members

DocumentFormat.OpenXml.Drawing Namespace