Vcl.Graphics.TCustomCanvas.Polyline

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure Polyline(const Points: array of TPoint); virtual; abstract;

C++

virtual void __fastcall Polyline(System::Types::TPoint const *Points, const int Points_High) = 0 ;

Properties

Type Visibility Source Unit Parent
procedure
function
public
Vcl.Graphics.pas
Vcl.Graphics.hpp
Vcl.Graphics TCustomCanvas

Description

Draws a series of lines on the canvas with the current pen, connecting each of the points passed to it in Points.

Override the Polyline method to implement connecting a set of points on the canvas. If you specify only two points, Polyline draws a single line.

The Points parameter is an array of points to be connected.

Note: In Delphi, you can use the Slice function to pass a portion of an array of points to the Polyline method. For example, to form a line connecting the first ten points from an array of 100 points, use the Slice function as follows: Canvas.Polyline(Slice(PointArray, 10));

Calling the MoveTo function with the value of the first point, and then repeatedly calling LineTo with all subsequent points will draw the same image on the canvas. However, unlike LineTo, Polyline does not change the value of PenPos.

See Also