SelectClipRgn-Funktion (wingdi.h)
Die SelectClipRgn-Funktion wählt eine Region als aktuellen Ausschneidebereich für den angegebenen Gerätekontext aus.
Syntax
int SelectClipRgn(
[in] HDC hdc,
[in] HRGN hrgn
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
[in] hrgn
Ein Handle für die region, die ausgewählt werden soll.
Rückgabewert
Der Rückgabewert gibt die Komplexität der Region an und kann einer der folgenden Werte sein.
| Rückgabecode | Beschreibung |
|---|---|
|
Region ist leer. |
|
Region ist ein einzelnes Rechteck. |
|
Region ist mehr als ein Rechteck. |
|
Ein Fehler ist aufgetreten. (Der vorherige Beschneidungsbereich ist nicht betroffen.) |
Hinweise
Es wird nur eine Kopie der ausgewählten Region verwendet. Die Region selbst kann für eine beliebige Anzahl anderer Gerätekontexte ausgewählt oder gelöscht werden.
Die SelectClipRgn-Funktion geht davon aus, dass die Koordinaten für eine Region in Geräteeinheiten angegeben werden.
Um die Abschneideregion eines Gerätekontexts zu entfernen, geben Sie ein NULL-Bereichshandle an.
Beispiele
Ein Beispiel finden Sie unter Clipping Output.
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 (einschließlich Windows.h) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |