Polylinienfunktion (wingdi.h)

Artikel
04.03.2024

Die Polyline-Funktion zeichnet eine Reihe von Liniensegmenten, indem sie die Punkte im angegebenen Array verbindet.

Syntax

BOOL Polyline(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] int         cpt
);

Parameter

[in] hdc

Ein Handle für einen Gerätekontext.

[in] apt

Ein Zeiger auf ein Array von POINT-Strukturen in logischen Einheiten.

[in] cpt

Die Anzahl der Punkte im Array. Diese Zahl muss größer oder gleich zwei sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Die Linien werden vom ersten Punkt bis hin zu nachfolgenden Punkten mit dem aktuellen Stift gezeichnet. Im Gegensatz zu den Funktionen LineTo oder PolylineTo verwendet die Polylinefunktion weder die aktuelle Position noch aktualisiert sie.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll