ExtSelectClipRgn-Funktion (wingdi.h)

Artikel
08/27/2023

Die ExtSelectClipRgn-Funktion kombiniert den angegebenen Bereich mit dem aktuellen Beschneidungsbereich unter Verwendung des angegebenen Modus.

Syntax

int ExtSelectClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] int  mode
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] hrgn

Ein Handle für die region, die ausgewählt werden soll. Dieses Handle darf nicht NULL sein, es sei denn, der RGN_COPY Modus ist angegeben.

[in] mode

Der Vorgang, der ausgeführt werden soll. Er muss einen der folgenden Werte aufweisen.

Wert	Bedeutung
RGN_AND	Der neue Beschneidungsbereich kombiniert die überlappenden Bereiche des aktuellen Beschneidungsbereichs und des durch hrgn identifizierten Bereichs.
RGN_COPY	Der neue Beschneidungsbereich ist eine Kopie der region, die durch hrgn identifiziert wird. Dies ist identisch mit SelectClipRgn. Wenn der durch hrgn identifizierte Bereich NULL ist, ist der neue Clippingbereich der Standardausschnittbereich (der Standardausschnittbereich ist eine NULL-Region).
RGN_DIFF	Der neue Beschneidungsbereich kombiniert die Bereiche des aktuellen Beschneidungsbereichs mit den Bereichen, die von der durch hrgn identifizierten Region ausgeschlossen sind.
RGN_OR	Der neue Beschneidungsbereich kombiniert den aktuellen Clippingbereich und den durch hrgn identifizierten Bereich.
RGN_XOR	Der neue Beschneidungsbereich kombiniert den aktuellen Beschneidungsbereich und den durch hrgn identifizierten Bereich, schließt jedoch überlappende Bereiche aus.

Rückgabewert

Der Rückgabewert gibt die Komplexität des neuen Clippingbereichs an. Dies kann einer der folgenden Werte sein.

Rückgabecode	Beschreibung
NULLREGION	Region ist leer.
SIMPLEREGION	Region ist ein einzelnes Rechteck.
KOMPLEXE REGION	Region ist mehr als ein Rechteck.
ERROR	Ein Fehler ist aufgetreten.

Hinweise

Wenn beim Aufrufen dieser Funktion ein Fehler auftritt, ist der vorherige Clippingbereich für den angegebenen Gerätekontext nicht betroffen.

Bei der ExtSelectClipRgn-Funktion wird davon ausgegangen, dass die Koordinaten für den angegebenen Bereich in Geräteeinheiten angegeben sind.

Es wird nur eine Kopie des durch den hrgn-Parameter identifizierten Bereichs verwendet. Die Region selbst kann nach diesem Aufruf wiederverwendet oder gelöscht werden.

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

Beschneidungsfunktionen

Übersicht über clipping

SelectClipRgn

Freigeben über