GetBoundsRect, fonction (wingdi.h)
La fonction GetBoundsRect obtient le rectangle englobant cumulé actuel pour un contexte d’appareil spécifié.
Le système gère un rectangle englobant cumulé pour chaque application. Une application peut récupérer et définir ce rectangle.
Syntaxe
UINT GetBoundsRect(
[in] HDC hdc,
[out] LPRECT lprect,
[in] UINT flags
);
Paramètres
[in] hdc
Handle du contexte d’appareil dont la fonction retourne le rectangle englobant.
[out] lprect
Pointeur vers la structure RECT qui recevra le rectangle englobant actuel. Le rectangle de l’application est retourné en coordonnées logiques, et le rectangle englobant est retourné en coordonnées d’écran.
[in] flags
Spécifie le comportement de la fonction GetBoundsRect . Ce paramètre peut être la valeur suivante.
| Valeur | Signification |
|---|---|
|
Efface le rectangle englobant après l’avoir retourné. Si cet indicateur n’est pas défini, le rectangle englobant n’est pas effacé. |
Valeur retournée
La valeur de retour spécifie l’état du rectangle englobant cumulé ; il peut s’agir de l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
| 0 | Une erreur est survenue. Le handle de contexte d’appareil spécifié n’est pas valide. |
| DCB_DISABLE | L’accumulation de limites est désactivée. |
| DCB_ENABLE | L’accumulation de limites est activée. |
| DCB_RESET | Le rectangle englobant est vide. |
| DCB_SET | Le rectangle englobant n’est pas vide. |
Remarques
La valeur DCB_SET est une combinaison des valeurs de bits DCB_ACCUMULATE et DCB_RESET. Les applications qui case activée le bit DCB_RESET pour déterminer si le rectangle englobant est vide doivent également case activée le bit DCB_ACCUMULATE. Le rectangle englobant est vide uniquement si le bit DCB_RESET est 1 et le bit DCB_ACCUMULATE est 0.
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 peinture et de dessin