Polyline.Points Property
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Gets or sets a collection that contains the vertex points of the Polyline.
Assembly: System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.
<Polyline Points="pointSet"/>
XAML Values
Property Value
Type: System.Windows.Media.PointCollectionA collection of Point structures that describe the vertex points of the Polyline. The default is Nothing.
Dependency property identifier field: PointsProperty
A single point, such as (0,0), is a valid value, but will not render anything because you need a minimum of two points to produce a rendered output.
pointSet Grammar
A valid pointSet for the Points property describes one or more points. As an example of the point set grammar, the string "0,0 50,100 100,0" would produce a "V" shaped polyline with its acute angle placed at 50,100.
X,Y[ X*,Y*]*
X, Y | A pair of double values that identify the x,y initial point of the polyline. |
X*,Y* | Subsequent pairs of double values that define additional points of this polyline. |
The [] characters are not literals; they are indicators of unbounded values. The * also is not literal and indicates that any number of points is permitted past the initial X,Y.
The separator in this grammar can be either a space or a comma. You can use a mixture of space and comma as separators. The common convention is to use commas between the X and Y, and spaces between the points.
Any odd number of double values in a Points value / set of points is not allowed and will throw either a parser or runtime error. The number of double values in the string must always be even so that it evaluates as x,y pairs of points.
The pointSet grammar behavior is implemented by a dedicated native-XAML type converter for PointCollection.