CloseFigure-Funktion (wingdi.h)

Artikel
03/04/2024

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