InvalidateRgn, fonction (winuser.h)

Article
08/27/2023

La fonction InvalidateRgn invalide la zone cliente dans la région spécifiée en l’ajoutant à la région de mise à jour actuelle d’une fenêtre. La région invalidée, ainsi que toutes les autres zones de la région de mise à jour, est marquée pour la peinture lorsque le message de WM_PAINT suivant se produit.

Syntaxe

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

Paramètres

[in] hWnd

Handle de la fenêtre avec une région de mise à jour qui doit être modifiée.

[in] hRgn

Handle de la région à ajouter à la région de mise à jour. La région est supposée avoir des coordonnées client. Si ce paramètre a la valeur NULL, la zone cliente entière est ajoutée à la région de mise à jour.

[in] bErase

Spécifie si l’arrière-plan de la région de mise à jour doit être effacé lors du traitement de la région de mise à jour. Si ce paramètre a la valeur TRUE, l’arrière-plan est effacé lorsque la fonction BeginPaint est appelée. Si le paramètre a la valeur FALSE, l’arrière-plan reste inchangé.

Valeur retournée

La valeur de retour est toujours différente de zéro.

Remarques

Les zones invalidées s’accumulent dans la région de mise à jour jusqu’à ce que le message WM_PAINT suivant soit traité ou jusqu’à ce que la région soit validée à l’aide de la fonction ValidateRect ou ValidateRgn .

Le système envoie un message WM_PAINT à une fenêtre chaque fois que sa région de mise à jour n’est pas vide et qu’il n’y a pas d’autres messages dans la file d’attente de l’application pour cette fenêtre.

La région spécifiée doit avoir été créée à l’aide de l’une des fonctions de région.

Si le paramètre bErase a la valeur TRUE pour n’importe quelle partie de la région de mise à jour, l’arrière-plan de la région entière est effacé, pas seulement dans la partie spécifiée.

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)