Freigeben über


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
NULLREGION
Region ist leer.
SIMPLEREGION
Region ist ein einzelnes Rechteck.
COMPLEXREGION
Region ist mehr als ein Rechteck.
ERROR
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

Weitere Informationen

Beschneidungsfunktionen

Übersicht über das Clipping

ExtSelectClipRgn