Freigeben über


IntersectClipRect-Funktion (wingdi.h)

Die IntersectClipRect-Funktion erstellt einen neuen Clippingbereich aus der Schnittmenge des aktuellen Clippingbereichs und des angegebenen Rechtecks.

Syntax

int IntersectClipRect(
  [in] HDC hdc,
  [in] int left,
  [in] int top,
  [in] int right,
  [in] int bottom
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] left

Die x-Koordinate in logischen Einheiten der oberen linken Ecke des Rechtecks.

[in] top

Die y-Koordinate in logischen Einheiten der oberen linken Ecke des Rechtecks.

[in] right

Die x-Koordinate in logischen Einheiten der unteren rechten Ecke des Rechtecks.

[in] bottom

Die y-Koordinate in logischen Einheiten der unteren rechten Ecke des Rechtecks.

Rückgabewert

Der Rückgabewert gibt den Typ des neuen Clippingbereichs an und 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. (Der aktuelle Beschneidungsbereich ist nicht betroffen.)

Hinweise

Die unteren und am weitesten rechten Rand des angegebenen Rechtecks werden aus dem Beschneidungsbereich ausgeschlossen.

Wenn noch kein Beschneidungsbereich vorhanden ist, wendet das System möglicherweise einen Standardausschnittbereich auf die angegebene HDC an. Ein Beschneidungsbereich wird dann aus der Schnittmenge dieses Standardausschnittbereichs und des in den Funktionsparametern angegebenen Rechtecks erstellt.

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

ExcludeClipRect