GetClipRgn-Funktion (wingdi.h)
Die GetClipRgn-Funktion ruft ein Handle ab, das den aktuellen anwendungsdefinierte Clippingbereich für den angegebenen Gerätekontext identifiziert.
Syntax
int GetClipRgn(
[in] HDC hdc,
[in] HRGN hrgn
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
[in] hrgn
Ein Handle für einen vorhandenen Bereich, bevor die Funktion aufgerufen wird. Nachdem die Funktion zurückgegeben wurde, ist dieser Parameter ein Handle für eine Kopie des aktuellen Beschneidungsbereichs.
Rückgabewert
Wenn die Funktion erfolgreich ist und kein Beschneidungsbereich für den angegebenen Gerätekontext vorhanden ist, ist der Rückgabewert null. Wenn die Funktion erfolgreich ist und ein Clippingbereich für den angegebenen Gerätekontext vorhanden ist, ist der Rückgabewert 1. Wenn ein Fehler auftritt, ist der Rückgabewert -1.
Hinweise
Ein anwendungsdefinierter Clippingbereich ist ein durch die SelectClipRgn-Funktion identifizierter Clippingbereich. Es handelt sich nicht um einen Beschneidungsbereich, der erstellt wird, wenn die Anwendung die BeginPaint-Funktion aufruft .
Wenn die Funktion erfolgreich ist, ist der hrgn-Parameter ein Handle für eine Kopie des aktuellen Clippingbereichs. Nachfolgende Änderungen an dieser Kopie wirken sich nicht auf den aktuellen Clippingbereich aus.
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 |