Partager via


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

Voir aussi

Référence

CWnd, classe

Graphique de la hiérarchie

CWnd::BeginPaint

GetUpdateRect

CWnd::OnPaint

CWnd::RedrawWindow