winuser.h


ScrollDC

La función ScrollDC desplaza un rectángulo de bits horizontal y verticalmente.

Sintaxis

BOOL ScrollDC(
    HDC hDC,                 // manipulador de contexto de dispositivo
    int dx,                  // unidades de desplazamiento horizontal
    int dy,                  // unidades de desplazamiento vertical
    CONST RECT *lprcScroll,  // dirección de estructura para el rectángulo de desplazamiento
    CONST RECT *lprcClip,    // dirección de estructura para el rectángulo de recorte
    HRGN hrgnUpdate,         // manipulador de región de desplazamiento
    LPRECT lprcUpdate        // dirección de estructura para rectángulo de actualización
   );

Parámetros:

hDC: identifica el contexto de dispositivo que contiene los bits a desplazar.

dx: especifica la cantidad, en unidades de dispositivo, de desplazamiento horizontal. Este parámetro debe ser un valor negativo para desplazar hacia la izquierda.

dy: especifica la cantidad, en unidades de dispositivo, de desplazamiento vertical. Este parámetro debe ser un valor negativo para desplazar hacia arriba.

lprcScroll: apunta a una estructura RECT que contiene las coordenadas del rectángulo a desplazar.

lprcClip: apunta a una estructura RECT que contiene las coordenadas del rectángulo de recorte. Sólo aquellos bits dentro del rectángulo de recorte se verán afectados. Los bits desplazados desde fuera del rectángulo a su interior son pintados; los desplazados desde el interior del rectángulo al exterior no.

hrgnUpdate: identifica la región no cubierta por el proceso de desplazamiento. ScrollDC define esta región; no es necesario un rectángulo.

lprcUpdate: apunta a una estructura RECT que recibe las coordenadas del rectángulo que bordea la región de actualización del desplazamiento. Se trata del área rectangular más grande que requiere ser repintada. Cuando la función regresa, los valores de esta estructura están en coordenadas de cliente, independientemente del modo de mapeo del contexto de dispositivo especificado. Esto permite a la aplicación usar la región de actualización en una llamada a la función InvalidateRgn, si es necesario.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si falla, el valor de retorno es cero. Para conseguir más información, se puede llamar a GetLastError.

Observaciones

Si el parámetro lprcUpdate es NULL, Windows no calcula el rectángulo de actualización. Si los parámetros hrgnUpdate y lprcUpdate son ambos NULL, Windows no calcula al región de actualización. Si hrgnUpdate no es NULL, Windows procede como si contuviese un manipulador válido de la región no cubierta por el proceso de desplazamiento (definida por ScrollDC).

Cuando se debe desplazar el área de cliente de una ventana completa, usar la función ScrollWindow; en otro caso, usar ScrollDC.