PathToRegion-Funktion (wingdi.h)

Die PathToRegion-Funktion erstellt einen Bereich aus dem ausgewählten Pfad in den angegebenen Gerätekontext. Der resultierende Bereich verwendet Gerätekoordinaten.

Syntax

HRGN PathToRegion(
  [in] HDC hdc
);

Parameter

[in] hdc

Handle für einen Gerätekontext, der einen geschlossenen Pfad enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, identifiziert der Rückgabewert eine gültige Region.

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

Hinweise

Wenn Sie das HRGN-Objekt nicht mehr benötigen, rufen Sie die DeleteObject-Funktion auf, um es zu löschen.

Der durch den hdc-Parameter identifizierte Gerätekontext muss einen geschlossenen Pfad enthalten.

Nachdem PathToRegion einen Pfad in eine Region konvertiert hat, verwirft das System den geschlossenen Pfad aus dem angegebenen Gerätekontext.

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