GetClipBox, fonction (wingdi.h)

  • Article

La fonction GetClipBox récupère les dimensions du rectangle englobant le plus étroit qui peut être dessiné autour de la zone visible actuelle sur l’appareil. La zone visible est définie par la zone de découpage actuelle ou le chemin d’clip, ainsi que par les fenêtres qui se chevauchent.

Syntaxe

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

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[out] lprect

Pointeur vers une structure RECT qui doit recevoir les dimensions du rectangle, en unités logiques.

Valeur retournée

Si la fonction réussit, la valeur de retour spécifie la complexité de la zone de découpage et peut être l’une des valeurs suivantes.

Code de retour Description
NULLREGION
 La région est vide.
SIMPLEREGION
 La région est un rectangle unique.
COMPLEXREGION
 La région est plusieurs rectangles.
ERROR
 Une erreur est survenue.
 

GetClipBox retourne des coordonnées logiques en fonction du contexte d’appareil donné.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

Fonctions de découpage

Vue d’ensemble de la coupe

RECT