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.
Assembly: System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.
<Polygon Points="pointSet"/>
XAML Values
Property Value
Type: System.Windows.Media.PointCollectionA collection of Point structures that describes the vertex points of the polygon. The default is Nothing. 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. |
X*,Y* | 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.