GetClipBox-Funktion (wingdi.h)

Die GetClipBox-Funktion ruft die Abmessungen des engsten begrenzungsenden Rechtecks ab, das um den aktuellen sichtbaren Bereich auf dem Gerät gezogen werden kann. Der sichtbare Bereich wird durch den aktuellen Beschneidungsbereich oder Clippfad sowie alle überlappenden Fenster definiert.

Syntax

int GetClipBox(
  [in]  HDC    hdc,
  [out] LPRECT lprect
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[out] lprect

Ein Zeiger auf eine RECT-Struktur , die die Rechteckdimensionen in logischen Einheiten empfangen soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt der Rückgabewert die Komplexität des Clippingfelds 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.

 

GetClipBox gibt logische Koordinaten basierend auf dem angegebenen Gerätekontext zurück.

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

RECT