Share via

ExtSelectClipRgn-Funktion (wingdi.h)

  • Artikel

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