PolyBezier-Funktion (wingdi.h)

Artikel
03/04/2024

Die PolyBezier-Funktion zeichnet eine oder mehrere Bézier-Kurven.

Syntax

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

Parameter

[in] hdc

Ein Handle für einen Gerätekontext.

[in] apt

Ein Zeiger auf ein Array von POINT-Strukturen , die die Endpunkte und Kontrollpunkte der Kurve(n) in logischen Einheiten enthalten.

[in] cpt

Die Anzahl der Punkte im lppt-Array . Dieser Wert muss mehr als das Dreifache der Anzahl der zu zeichnenden Kurven sein, da jede Bézierkurve zwei Kontrollpunkte und einen Endpunkt erfordert, und die anfängliche Kurve einen zusätzlichen Startpunkt erfordert.

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 PolyBezier-Funktion zeichnet kubische Bézierkurven mithilfe der Endpunkte und Kontrollpunkte, die durch den lppt-Parameter angegeben sind. Die erste Kurve wird vom ersten Punkt zum vierten Punkt gezeichnet, indem der zweite und der dritte Punkt als Kontrollpunkte verwendet werden. Jede nachfolgende Kurve in der Sequenz benötigt genau drei weitere Punkte: Der Endpunkt der vorherigen Kurve wird als Ausgangspunkt verwendet, die nächsten beiden Punkte in der Sequenz sind Kontrollpunkte, und der dritte ist der Endpunkt.

Die aktuelle Position wird von der PolyBezier-Funktion weder verwendet noch aktualisiert. Die Abbildung ist nicht gefüllt.

Diese Funktion zeichnet Linien mit dem aktuellen Stift.

Beispiele

Ein Beispiel finden Sie unter Neuzeichnen in der Updateregion.

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