Fonction SetBoundsRect (wingdi.h)

Article
08/27/2023

La fonction SetBoundsRect contrôle l’accumulation d’informations de rectangle englobant pour le contexte d’appareil spécifié. Le système peut gérer un rectangle englobant pour toutes les opérations de dessin. Une application peut examiner et définir ce rectangle. Les limites de dessin sont utiles pour invalider les caches bitmap.

Syntaxe

UINT SetBoundsRect(
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

Paramètres

[in] hdc

Handle du contexte d’appareil pour lequel accumuler des rectangles englobants.

[in] lprect

Pointeur vers une structure RECT utilisée pour définir le rectangle englobant. Les dimensions rectangle sont en coordonnées logiques. Ce paramètre peut être NULL.

[in] flags

Spécifie la façon dont le nouveau rectangle sera combiné avec le rectangle accumulé. Ce paramètre peut être l’une des valeurs suivantes.

Valeur	Signification
DCB_ACCUMULATE	Ajoute le rectangle spécifié par le paramètre lprcBounds au rectangle englobant (à l’aide d’une opération d’union de rectangle). À l’aide de DCB_RESET et de DCB_ACCUMULATE définit le rectangle englobant sur le rectangle spécifié par le paramètre lprcBounds .
DCB_DISABLE	Désactive l’accumulation de limites.
DCB_ENABLE	Active l’accumulation de limites, qui est désactivée par défaut.
DCB_RESET	Efface le rectangle englobant.

Valeur retournée

Si la fonction réussit, la valeur de retour spécifie l’état précédent du rectangle englobant. Cet état peut être une combinaison des valeurs suivantes.

Valeur	Signification
DCB_DISABLE	L’accumulation de limites est désactivée.
DCB_ENABLE	L’accumulation de limites est activée. DCB_ENABLE et DCB_DISABLE s’excluent mutuellement.
DCB_RESET	Le rectangle englobant est vide.
DCB_SET	Le rectangle englobant n’est pas vide. DCB_SET et DCB_RESET s’excluent mutuellement.

Si la fonction échoue, la valeur de retour est égale à zéro.

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 n’est vide que si le bit DCB_RESET est 1 et le DCB_ACCUMULATE bit est 0.

Configuration requise


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

GetBoundsRect

Fonctions de peinture et de dessin

Vue d’ensemble de la peinture et du dessin

RECT

Partager via