Polygon.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 polygon.

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


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

XAML Values

  • pointSet
    See "pointSet Grammar" in Remarks.

Property Value

Type: System.Windows.Media..::.PointCollection
A collection of Point structures that describes the vertex points of the polygon. The default is nullNothingnullptra null reference (Nothing in Visual Basic). The value can be expressed as a string as described in "pointSet Grammar" below.


Dependency property identifier field: PointsProperty

A single point specified as Points for a Polygon, such as (0,0), is a valid value as far as parsing and the object model, but it will not render anything because you need a minimum of two points to produce a rendered output.

Two points will render, but you could also have used a Line for this same result.

pointSet Grammar

A valid pointSet for the Points property describes one or more points. As an example of the points grammar, the string "0,0,100,0,0,100" would produce a right triangle with its right angle placed at 0,0.

X,Y[ X*,Y*]*

X, Y

A pair of double values that identify the x,y initial point of the polygon.


Subsequent pairs of double values that define additional points of this object.

  • 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


Windows Phone

See Also


Polygon Class

System.Windows.Shapes Namespace