Vcl.Graphics.TCanvas.Polyline

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure Polyline(const Points: array of TPoint); override;

C++

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
Vcl.Graphics.pas
Vcl.Graphics.hpp
Vcl.Graphics TCanvas

Beschreibung

Zeichnet unter Verwendung des aktuellen Stiftes eine Folge von Linien auf der Zeichenfläche. Dazu werden die in Points übergebenen Punkte miteinander verbunden.

Mit der Methode Polyline können Sie auf der Zeichenfläche eine Reihe von Punkten miteinander verbinden. Wenn nur zwei Punkte zu verbinden sind, zeichnet Polyline eine Linie.

Der Parameter Points ist ein Array mit den zu verbindenden Punkten.

Anmerkung:  Points_Size gibt den Index des letzten Punkts im Array an (dieser Wert ist um eins kleiner als die Punktanzahl).

Anmerkung:  In Delphi können Sie mit der Funktion Slice einen Teil des Punkte-Arrays an die Methode Polyline übergeben. Wenn Sie z.B. ein Linie zeichnen möchten, welche die ersten zehn Punkten eines aus 100 Punkten bestehenden Arrays miteinander verbindet, verwenden Sie Slice folgendermaßen:

Canvas.Polyline(Slice(PointArray, 10));

Ein Aufruf der Funtion MoveTo mit dem Wert des ersten Punktes und wiederholte Aufrufe von LineTo mit allen weiteren Punkten führen zum selben Ergebnis. Im Gegensatz zu LineTo ändert Polyline jedoch nicht den Wert von PenPos.

Siehe auch

Codebeispiele