InvalidateRgn, fonction (winuser.h)
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.
BOOL InvalidateRgn(
[in] HWND hWnd,
[in] HRGN hRgn,
[in] BOOL bErase
);
[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é.
La valeur de retour est toujours différente de zéro.
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.
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) |
Fonctions de peinture et de dessin