GetBoundsRect, fonction (wingdi.h)

  • Article

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
DCB_RESET
 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

Vue d’ensemble de la peinture et du dessin

SetBoundsRect