GetUpdateRect, fonction (winuser.h)

Article
08/27/2023

La fonction GetUpdateRect récupère les coordonnées du plus petit rectangle qui entoure complètement la région de mise à jour de la fenêtre spécifiée. GetUpdateRect récupère le rectangle en coordonnées logiques. S’il n’existe aucune région de mise à jour, GetUpdateRect récupère un rectangle vide (définit toutes les coordonnées sur zéro).

Syntaxe

BOOL GetUpdateRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect,
  [in]  BOOL   bErase
);

Paramètres

[in] hWnd

Gérez la fenêtre dont la région de mise à jour doit être récupérée.

[out] lpRect

Pointeur vers la structure RECT qui reçoit les coordonnées, en unités d’appareil, du rectangle englobant.

Une application peut définir ce paramètre sur NULL pour déterminer s’il existe une région de mise à jour pour la fenêtre. Si ce paramètre a la valeur NULL, GetUpdateRect retourne une valeur différente de zéro si une région de mise à jour existe, et zéro si ce n’est pas le cas. Cela fournit un moyen simple et efficace de déterminer si un message WM_PAINT résulte d’une zone non valide.

[in] bErase

Spécifie si l’arrière-plan de la région de mise à jour doit être effacé. Si ce paramètre a la valeur TRUE et que la région de mise à jour n’est pas vide, GetUpdateRect envoie un message WM_ERASEBKGND à la fenêtre spécifiée pour effacer l’arrière-plan.

Valeur retournée

Si la région de mise à jour n’est pas vide, la valeur de retour est différente de zéro.

S’il n’y a pas de région de mise à jour, la valeur de retour est zéro.

Remarques

Le rectangle de mise à jour récupéré par la fonction BeginPaint est identique à celui récupéré par GetUpdateRect.

BeginPaint valide automatiquement la région de mise à jour. Ainsi, tout appel à GetUpdateRect effectué immédiatement après l’appel à BeginPaint récupère une région de mise à jour vide.

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	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-draw-l1-1-0 (introduit dans Windows 8)