CDC::ScrollDC

Artículo
04/10/2013

Desplaza un rectángulo de bits horizontal y verticalmente.

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

Parámetros

dx
Especifica el número de unidades horizontales de desplazamiento.
dy
Especifica el número de unidades de desplazamiento vertical.
lpRectScroll
Señala la estructura de RECT o el objeto de CRect que contiene las coordenadas del rectángulo de desplazamiento.
lpRectClip
Señala la estructura de RECT o el objeto de CRect que contiene las coordenadas del rectángulo de recorte.Cuando este rectángulo es menor que el original indicada por lpRectScroll, desplazamiento sólo aparece en el rectángulo más pequeño.
pRgnUpdate
Identifica la región destapada por el proceso de desplazamiento.la función de ScrollDC define esta región; no es necesariamente un rectángulo.
lpRectUpdate
Señala la estructura de RECT o el objeto de CRect que recibe las coordenadas del rectángulo que limita la región de actualización de desplazamiento.Es el área rectangular mayor que requiere la repintura.Los valores de la estructura o el objeto cuando finaliza la función están en coordenadas del cliente, independientemente del modo de asignación para el contexto especificado del dispositivo.

Valor devuelto

Distinto de cero si desplaza se ejecuta; si no 0.

Comentarios

Si lpRectUpdate es NULL, Windows no calcula el rectángulo de actualización.si pRgnUpdate y lpRectUpdate son NULL, Windows no calcula la región de actualización.Si pRgnUpdate no es NULL, Windows supone que contiene un puntero válido a la región destapada por el proceso de desplazamiento (definido por la función miembro de ScrollDC ).La región de actualización devuelta en lpRectUpdate puede pasarse a CWnd::InvalidateRgn si es necesario.

Una aplicación debe utilizar la función miembro de ScrollWindow de la clase CWnd cuando es necesario desplazarse toda el área de cliente de una ventana.si no, debe utilizar ScrollDC.