BeginPath-Funktion (wingdi.h)

Artikel
08/27/2023

Die BeginPath-Funktion öffnet eine Pfadklammer im angegebenen Gerätekontext.

Syntax

BOOL BeginPath(
  [in] HDC hdc
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

Rückgabewert

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

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

Hinweise

Nachdem eine Pfadklammer geöffnet wurde, kann eine Anwendung mit dem Aufrufen von GDI-Zeichenfunktionen beginnen, um die Punkte zu definieren, die sich im Pfad befinden. Eine Anwendung kann eine offene Pfadklammer durch Aufrufen der EndPath-Funktion schließen.

Wenn eine Anwendung BeginPath für einen Gerätekontext aufruft, werden alle vorherigen Pfade aus diesem Gerätekontext verworfen. Die folgende Liste zeigt, welche Zeichnungsfunktionen verwendet werden können.

Beispiele

Ein Beispiel finden Sie unter Verwenden von Pfaden.

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