CWnd::GetUpdateRect

BOOLGetUpdateRect (LPRECTlpRect,BOOLbErase=faux);

Valeur de retour

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

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

Paramètres

lpRect

Pointe vers un objet CRect ou structure RECT qui doit recevoir les coordonnées du client de la mise à jour qui entoure la région mise à jour.

Définissez ce paramètre à NULL pour déterminer l'existence d'une région de mise à jour dans le CWnd. Si lpRect est NULL, la fonction de membre GetUpdateRect renvoie zéro si une région de mise à jour existe et 0 s'il ne le fait pas. Cela permet de déterminer si un message WM_PAINT résultait d'une zone non valide. Ne définissez pas ce paramètre à NULL dans Windows version 3.0 et versions antérieures.

bErase

Spécifie si l'arrière-plan de la région de mise à jour doit être effacé.

Remarques

Récupère les coordonnées du plus petit rectangle qui entoure complètement la région mise à jour. Si CWnd créée avec le style CS_OWNDC , et ce n'est pas le mode de mappage MM_TEXT, la fonction de membre GetUpdateRect donne le rectangle en coordonnées logiques. Sinon, GetUpdateRect donne le rectangle client coordonnées. Si il n'y a aucune région de mise à jour, GetUpdateRect définit le rectangle est vide (définit les coordonnées à 0).

Le paramètre bErase spécifie si GetUpdateRect devrait effacer l'arrière-plan de la région de mise à jour. Si bErase est TRUE et que la région de mise à jour n'est pas vide, l'arrière-plan est effacé. Pour effacer l'arrière-plan, GetUpdateRect envoie le message WM_ERASEBKGND.

Le rectangle de mise à jour récupéré par la fonction membre BeginPaint est identique à celle récupérée par la fonction membre GetUpdateRect.

La fonction de membre BeginPaint valide automatiquement la région mise à jour, si bien que tout appel à la GetUpdateRect faite immédiatement après un appel à BeginPaint extrait une région vide mise à jour.

Aperçu de CWnd |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CWnd::BeginPaint, :: GetUpdateRect, CWnd::OnPaint, CWnd::RedrawWindow

Index