ValidateRect, fonction (winuser.h)

Article
08/28/2023

La fonction ValidateRect valide la zone cliente dans un rectangle en supprimant le rectangle de la région de mise à jour de la fenêtre spécifiée.

Syntaxe

BOOL ValidateRect(
  [in] HWND       hWnd,
  [in] const RECT *lpRect
);

Paramètres

[in] hWnd

Gérez la fenêtre dont la région de mise à jour doit être modifiée. Si ce paramètre a la valeur NULL, le système invalide et redessine toutes les fenêtres et envoie les messages WM_ERASEBKGND et WM_NCPAINT à la procédure de fenêtre avant que la fonction ne retourne.

[in] lpRect

Pointeur vers une structure RECT qui contient les coordonnées client du rectangle à supprimer de la région de mise à jour. Si ce paramètre a la valeur NULL, la zone cliente entière est supprimée.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

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

Remarques

La fonction BeginPaint valide automatiquement l’ensemble de la zone cliente. Ni la fonction ValidateRect ni ValidateRgn ne doivent être appelées si une partie de la région de mise à jour doit être validée avant la génération du message WM_PAINT suivant.

Le système continue à générer des messages WM_PAINT jusqu’à ce que la région de mise à jour actuelle soit validée.

Spécifications


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)