• Article

Polyline.Points Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets a collection that contains the vertex points of the Polyline.

Namespace:  System.Windows.Shapes
Assembly:  System.Windows (in System.Windows.dll)

Syntax

'Declaration
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 nulla 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

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.