Partager via


ValidateRect, fonction (winuser.h)

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)

Voir aussi

BeginPaint

InvalidateRect

InvalidateRgn

Fonctions de peinture et de dessin

Vue d’ensemble de la peinture et du dessin

RECT

ValidateRgn

WM_PAINT