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.

Namespace: System.Windows.Shapes
Assembly: System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.

Syntax

Public Property Points As PointCollection
public PointCollection Points { get; set; }
<Polyline Points="pointSet"/>

XAML Values

  • pointSet
    See "pointSet Grammar" in Remarks.

Property Value

Type: System.Windows.Media..::.PointCollection
A collection of Point structures that describe the vertex points of the Polyline. The default is nullNothingnullptra null reference (Nothing in Visual Basic).

Remarks

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.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

Polyline Class

System.Windows.Shapes Namespace