CWnd::GetUpdateRect

Article
03/04/2013

Récupère les coordonnées du plus petit rectangle qui englobe complètement la zone de mise à jour.

BOOL GetUpdateRect(
   LPRECT lpRect,
   BOOL bErase = FALSE 
);

Paramètres

lpRect
Les points à CRect objet ou les structures de RECT qui est de recevoir les coordonnées clientes de la mise à jour qui englobe la zone de mise à jour.

Affectez à ce paramètre la NULL pour déterminer si une zone de mise à jour existe dans CWnd.Si lpRect est NULL, la fonction membre d' GetUpdateRect retourne une valeur différente de zéro si une zone de mise à jour existe et 0 s'il n'est pas le cas.Cela permet de déterminer si un message d' WM_PAINT ont résulté d'une zone non valide.Ne définissez pas ce paramètre à NULL dans la version de Windows 3,0 et antérieures.
bErase
Spécifie si l'arrière-plan dans la région de mise à jour doit être supprimé.

Valeur de retour

Spécifie l'état de la zone de mise à jour.La valeur est différente de zéro si la zone de mise à jour n'est pas vide ; sinon 0.

Si le paramètre d' lpRect a la valeur NULL, la valeur de retour est différente de zéro si une zone de mise à jour existe ; sinon 0.

Notes

Si CWnd a été créé avec le style de CS_OWNDC et le mode de mappage n'est pas MM_TEXT, la fonction membre d' GetUpdateRect montre le rectangle dans les coordonnées logiques.Sinon, GetUpdateRect montre le rectangle dans les coordonnées clientes.S'il n'existe aucune zone de mise à jour, GetUpdateRect définit le rectangle pour être vide (affecte toutes les coordonnées à 0).

Le paramètre d' bErase spécifie si GetUpdateRect doit supprimer l'arrière-plan de la zone de mise à jour.Si bErase est TRUE et la zone de mise à jour n'est pas vide, l'arrière-plan est supprimé.Pour effacer l'arrière-plan, GetUpdateRect envoie le message de WM_ERASEBKGND .

Le rectangle de mise à jour extrait par la fonction membre de BeginPaint est identique à celle extrait par la fonction membre d' GetUpdateRect .

La fonction membre d' BeginPaint valide automatiquement la zone de mise à jour, donc n'importe quel appel à GetUpdateRect a effectué immédiatement après un appel à BeginPaint extrait une zone de mise à jour vide.