CDC::ScrollDC

Article
03/26/2013

Fait défiler un rectangle de bits horizontalement et verticalement.

BOOL ScrollDC(
   int dx,
   int dy,
   LPCRECT lpRectScroll,
   LPCRECT lpRectClip,
   CRgn* pRgnUpdate,
   LPRECT lpRectUpdate 
);

Paramètres

dx
Spécifie le nombre d'unités horizontales de défilement.
Dy
Spécifie le nombre d'unités de défilement verticale.
lpRectScroll
Les points à RECT structure ou l'objet d' CRect qui contiennent les coordonnées du rectangle de défilement.
lpRectClip
Les points à RECT structure ou l'objet d' CRect qui contiennent les coordonnées du rectangle de découpage.Lorsque ce rectangle est plus petit que le d'origine globale pointe vers lpRectScroll, le défilement se produit uniquement dans le rectangle plus petit.
pRgnUpdate
Identifie la zone découverte par le processus de défilement.La fonction d' ScrollDC définit cette zone ; ce n'est pas nécessairement un rectangle.
lpRectUpdate
Les points à RECT structure ou l'objet d' CRect qui acceptent les coordonnées du rectangle limites de la zone de mise à jour de défilement.C'est la plus grande zone rectangulaire qui requiert redessiner.Les valeurs de la structure ou l'objet lorsque les retours de fonction sont dans les coordonnées clientes, quel que soit le mode de mappage pour le contexte donné de périphérique.

Valeur de retour

Une valeur différente de zéro si le défilement est exécuté ; sinon 0.

Notes

Si lpRectUpdate est NULL, les fenêtres ne calcule pas le rectangle de mise à jour.Si pRgnUpdate et lpRectUpdate sont NULL, les fenêtres ne calcule pas la zone de mise à jour.Si pRgnUpdate n'est pas NULL, les fenêtres suppose qu'il contient un pointeur valide à la zone découverte par le processus de défilement (défini par la fonction membre d' ScrollDC ).La zone de mise à jour retournée dans lpRectUpdate peut être passée si nécessaire à CWnd::InvalidateRgn .

Une application doit utiliser la fonction membre d' ScrollWindow de la classe CWnd lorsqu'il est nécessaire de faire défiler la zone cliente entière d'une fenêtre.Sinon, elle doit utiliser ScrollDC.