CloseFigure-Funktion (wingdi.h)

Die CloseFigure-Funktion schließt eine geöffnete Abbildung in einem Pfad.

Syntax

BOOL CloseFigure(
  [in] HDC hdc
);

Parameter

[in] hdc

Behandeln Sie den Gerätekontext, in dem die Abbildung geschlossen wird.

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 CloseFigure-Funktion schließt die Abbildung, indem sie eine Linie von der aktuellen Position bis zum ersten Punkt der Abbildung zeichnet (in der Regel der durch den letzten Aufruf der MoveToEx-Funktion angegebene Punkt) und dann die Linien mithilfe des Linienverbindungsstils verbindet. Wenn eine Abbildung mithilfe der LineTo-Funktion anstelle von CloseFigure geschlossen wird, werden Endkappen verwendet, um die Ecke anstelle eines Joins zu erstellen.

Die CloseFigure-Funktion sollte nur aufgerufen werden, wenn im angegebenen Gerätekontext eine offene Pfadklammer vorhanden ist.

Eine Abbildung in einem Pfad ist geöffnet, es sei denn, sie wird mithilfe dieser Funktion explizit geschlossen. (Eine Abbildung kann auch geöffnet sein, wenn der aktuelle Punkt und der Startpunkt der Abbildung identisch sind.)

Nach einem Aufruf von CloseFigure startet das Hinzufügen einer Linie oder Kurve zum Pfad eine neue Abbildung.

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

Weitere Informationen

BeginPath

EndPath

ExtCreatePen

Lineto

MoveToEx

Pfadfunktionen

Pfadübersicht