Polygon.Points Property (System.Windows.Shapes)

Points Property

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

Polygon..::.Points Property

Gets or sets a collection that contains the vertex points of the polygon. This is a dependency property.

Namespace: System.Windows.Shapes
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

Visual Basic (Declaration)

Public Property Points As PointCollection

Visual Basic (Usage)

Dim instance As Polygon
Dim value As PointCollection

value = instance.Points

instance.Points = value

public PointCollection Points { get; set; }

Visual C++

public:
property PointCollection^ Points {
    PointCollection^ get ();
    void set (PointCollection^ value);
}

JScript

public function get Points () : PointCollection
public function set Points (value : PointCollection)

XAML Property Element Usage

<object>
  <object.Points>
    <PointCollection .../>
  </object.Points>
</object>

XAML Attribute Usage

<object Points="PointCollection" .../>

Property Value

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

Dependency Property Information

Identifier field	PointsProperty
Metadata properties set to true	AffectsRender, AffectsMeasure

Remarks

In Extensible Application Markup Language (XAML), use a space-delimited list of comma-separated x-coordinate and y-coordinate pairs to set this attribute. Use simple notation, that is, x1,y1 x2,y2 ... xn,yn.

Examples

The following example shows how to create a Polygon element and set the Points property by using code. For the complete sample, see WPF Shapes Gallery Sample.

Visual Basic

' Add a Polygon Element
Dim myPolygon As New Polygon()
myPolygon.Stroke = Brushes.Black
myPolygon.Fill = Brushes.LightSeaGreen
myPolygon.StrokeThickness = 2
myPolygon.HorizontalAlignment = HorizontalAlignment.Left
myPolygon.VerticalAlignment = VerticalAlignment.Center
Dim Point1 As New System.Windows.Point(1, 50)
Dim Point2 As New System.Windows.Point(10, 80)
Dim Point3 As New System.Windows.Point(50, 50)
Dim myPointCollection As New PointCollection()
myPointCollection.Add(Point1)
myPointCollection.Add(Point2)
myPointCollection.Add(Point3)
myPolygon.Points = myPointCollection
myGrid.Children.Add(myPolygon)

Visual C++

//Add the Polygon Element
myPolygon = gcnew Polygon();
myPolygon->Stroke = Brushes::Black;
myPolygon->Fill = Brushes::LightSeaGreen;
myPolygon->StrokeThickness = 2;
myPolygon->HorizontalAlignment = HorizontalAlignment::Left;
myPolygon->VerticalAlignment = VerticalAlignment::Center;
Point Point1 = Point(1, 50);
Point Point2 = Point(10, 80);
Point Point3 = Point(50, 50);
PointCollection^ myPointCollection = gcnew PointCollection();
myPointCollection->Add(Point1);
myPointCollection->Add(Point2);
myPointCollection->Add(Point3);
myPolygon->Points = myPointCollection;
myGrid->Children->Add(myPolygon);

//Add the Polygon Element
myPolygon = new Polygon();
myPolygon.Stroke = System.Windows.Media.Brushes.Black;
myPolygon.Fill = System.Windows.Media.Brushes.LightSeaGreen;
myPolygon.StrokeThickness = 2;
myPolygon.HorizontalAlignment = HorizontalAlignment.Left;
myPolygon.VerticalAlignment = VerticalAlignment.Center;
System.Windows.Point Point1 = new System.Windows.Point(1, 50);
System.Windows.Point Point2 = new System.Windows.Point(10,80);
System.Windows.Point Point3 = new System.Windows.Point(50,50);
PointCollection myPointCollection = new PointCollection();
myPointCollection.Add(Point1);
myPointCollection.Add(Point2);
myPointCollection.Add(Point3);
myPolygon.Points = myPointCollection;
myGrid.Children.Add(myPolygon);

More Code

How to: Draw a Closed Shape by Using the Polygon Element

This example shows how to draw a closed shape by using the Polygon element. To draw a closed shape, create a Polygon element and use its Points property to specify the vertices of a shape. A line is automatically drawn that connects the first and last points. Finally, specify a Fill, a Stroke, or both.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

Polygon Class

Polygon Members

System.Windows.Shapes Namespace

Point