ExcludeClipRect-Funktion (wingdi.h)

Artikel
08/27/2023

Die ExcludeClipRect-Funktion erstellt einen neuen Beschneidungsbereich, der aus dem vorhandenen Clippingbereich abzüglich des angegebenen Rechtecks besteht.

Syntax

int ExcludeClipRect(
  [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 die Komplexität des neuen Abschneidebereichs an. Es kann sich um einen der folgenden Werte handeln.

Rückgabecode	Beschreibung
NULLREGION	Region ist leer.
SIMPLEREGION	Region ist ein einzelnes Rechteck.
COMPLEXREGION	Region ist mehr als ein Rechteck.
ERROR	Es wurde keine Region erstellt.

Hinweise

Der untere und rechte Rand des angegebenen Rechtecks sind nicht aus dem Abschneidebereich ausgeschlossen.

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

IntersectClipRect

Share via