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

Weitere Informationen

BeginPaint

Beschneidungsfunktionen

Übersicht über clipping

SelectClipRgn