Partager via


ValidateRgn, fonction (winuser.h)

La fonction ValidateRgn valide la zone cliente dans une région en supprimant la région de la région de mise à jour actuelle de la fenêtre spécifiée.

Syntaxe

BOOL ValidateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

Paramètres

[in] hWnd

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

[in] hRgn

Gérez vers une région qui définit la zone à 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 région spécifiée doit avoir été créée par une fonction de région. Les coordonnées de région sont supposées être des coordonnées client.

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.

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

ExcludeUpdateRgn

InvalidateRect

InvalidateRgn

Fonctions de peinture et de dessin

Vue d’ensemble de la peinture et du dessin

ValidateRect

WM_PAINT