Method # Graphics.DrawPolygon ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Warning
This item was deprecated in version 2020r1. Please use `Graphics.DrawPath` as a replacement.
## Description Draws a polygon using the values in the 1-based array passed as the X and Y coordinates. The polygon is drawn in the current color. The current color is set with the `Graphics.DrawingColor` property. ## Notes Odd numbered array elements are X coordinates and even numbered array elements are Y coordinates. ## Sample code Polygons are drawn using the DrawPolygon and FillPolygon methods of the `Graphics` class. Polygons are drawn by passing the DrawPolygon or FillPolygon method an `Integer` array that contains each point in the polygon. This is a 1-based array where odd numbered array elements contain X values and even numbered array elements contain Y coordinates. This means that element 1 contains the X coordinate of the first point in the polygon and element 2 contains the Y coordinate of the first point in the polygon. Consider the following array values: {\| cellpadding="8" cellspacing="0" border="1" ! width=30% style="background-color:#e0e0e0" Value 1 -5 3 -40 5 -60 \|} When passed to the DrawPolygon or FillPolygon method, this array would draw a polygon by drawing a line starting at 10,5 and ending at 40,40 then drawing another line starting from 40,40 ending at 5,60 and finally a line from 5,60 back to 10,5 to complete the polygon. This polygon has only three sets of coordinates so it is a triangle. The code in the Paint event of a `Canvas` control or `Window` to draw this polygon, looks like this. The code is in the Paint event. ``` xojo Var points(6) As Double points(1) = 10 points(2) = 5 points(3) = 40 points(4) = 40 points(5) = 5 points(6) = 60 g.DrawPolygon(points) ``` --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- FillPolygon draws the same polygon but with the interior filled with the ForeColor: > ![image](images/graphics.drawpolygon_usersguide_figure_345a.jpg) Another way of populating the array is with the `Array` function. The `Array` function takes a list of values separated by commas and populates the array, beginning with element zero. Since the first element that DrawPolygon uses is element 1, you can use any value in element zero. This code is in the Paint event. ``` xojo Var points() As Double points = Array(0, 10, 5, 40, 40, 5, 60) g.DrawPolygon(points) ``` ## Compatibility All project types on all supported operating systems.