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.
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) |
Voir aussi
Fonctions de peinture et de dessin
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour