CWnd::GetUpdateRect
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.
Configuration requise
Header: afxwin.h