ValidateRgn, fonction (winuser.h)

Article
03/04/2024

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)