PolylineTo-Funktion (wingdi.h)

Artikel
08/27/2023

Die PolylineTo-Funktion zeichnet eine oder mehrere gerade Linien.

Syntax

BOOL PolylineTo(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] DWORD       cpt
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] apt

Ein Zeiger auf ein Array von POINT-Strukturen , das die Scheitelpunkte der Linie in logischen Einheiten enthält.

[in] cpt

Die Anzahl der Punkte im Array.

Rückgabewert

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

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

Hinweise

Im Gegensatz zur Polyline-Funktion verwendet und aktualisiert die PolylineTo-Funktion die aktuelle Position.

Mit dem aktuellen Stift wird eine Linie von der aktuellen Position bis zum ersten punkt gezeichnet, der vom lppt-Parameter angegeben wird. Für jede zusätzliche Zeile zeichnet die Funktion vom Endpunkt der vorherigen Zeile bis zum nächsten Punkt, der von lppt angegeben wird.

PolylineTo verschiebt die aktuelle Position an den Endpunkt der letzten Zeile.

Wenn die von dieser Funktion gezeichneten Liniensegmente eine geschlossene Abbildung bilden, wird die Abbildung nicht ausgefüllt.

Anforderungen


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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll