Partager via


CWnd::InvalidateRgn

Invalide la zone cliente dans la zone donnée en l'ajoutant à la zone de mise à jour actuelle d' CWnd.

void InvalidateRgn(
   CRgn* pRgn,
   BOOL bErase = TRUE 
);

Paramètres

  • pRgn
    Un pointeur vers un objet de CRgn qui identifie la zone à ajouter à la zone de mise à jour.Il est supposé que la zone a des coordonnées clientes.Si ce paramètre est NULL, la zone cliente entière est ajoutée à la zone de mise à jour.

  • bErase
    Spécifie si l'arrière-plan dans la zone de mise à jour doit être supprimé.

Notes

La zone invalidée, avec toutes autres zones dans la région de mise à jour, est marquée pour peindre lorsque le message de WM_PAINT est ensuite envoyé.Les zones invalidées accumulate dans la région de mise à jour jusqu'à ce que la zone a traité lorsqu'un message d' WM_PAINT est ensuite envoyé, ou jusqu'à la zone est validé par la fonction membre de ValidateRect ou de ValidateRgn .

Le paramètre d' bErase spécifie si l'arrière-plan dans la zone de mise à jour doit être supprimé lorsque la zone de mise à jour est traitée.Si bErase est TRUE, l'arrière-plan est supprimé lorsque la fonction membre de BeginPaint est appelée ; si bErase est FALSE, l'arrière-plan reste inchangée.Si bErase est TRUE pour n'importe quelle partie de la zone de mise à jour, l'arrière-plan dans la zone entière, pas seulement à la partie donnée, est supprimé.

Les fenêtres envoie un message de WM_PAINT chaque fois que la zone de mise à jour d' CWnd n'est pas vide et qu'il n'y a aucun message de la file d'attente d'application pour cette fenêtre.

La zone donnée doit avoir été précédemment créée par l'une des fonctions de zone.

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CWnd, classe

Graphique de la hiérarchie

CWnd::BeginPaint

CWnd::ValidateRect

CWnd::ValidateRgn

InvalidateRgn

CWnd::Invalidate

CWnd::InvalidateRect