SelectClipRgn-Funktion (wingdi.h)

Artikel
08/27/2023

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

Share via