Freigeben über


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