Función ScrollDC (winuser.h)

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

Sintaxis

BOOL ScrollDC(
  [in]  HDC        hDC,
  [in]  int        dx,
  [in]  int        dy,
  [in]  const RECT *lprcScroll,
  [in]  const RECT *lprcClip,
  [in]  HRGN       hrgnUpdate,
  [out] LPRECT     lprcUpdate
);

Parámetros

[in] hDC

Tipo: HDC

Identificador del contexto del dispositivo que contiene los bits que se van a desplazar.

[in] dx

Tipo: int

Especifica la cantidad, en unidades de dispositivo, de desplazamiento horizontal. Este parámetro debe tener un valor negativo para desplazarse a la izquierda.

[in] dy

Tipo: int

Especifica la cantidad, en unidades de dispositivo, de desplazamiento vertical. Este parámetro debe tener un valor negativo para desplazarse hacia arriba.

[in] lprcScroll

Tipo: const RECT*

Puntero a una estructura RECT que contiene las coordenadas de los bits que se van a desplazar. Los únicos bits afectados por la operación de desplazamiento son bits en la intersección de este rectángulo y el rectángulo especificado por lprcClip. Si lprcScroll es NULL, se usa todo el área de cliente.

[in] lprcClip

Tipo: const RECT*

Puntero a una estructura RECT que contiene las coordenadas del rectángulo de recorte. Los únicos bits que se pintarán son los bits que permanecen dentro de este rectángulo una vez completada la operación de desplazamiento. Si lprcClip es NULL, se usa todo el área de cliente.

[in] hrgnUpdate

Tipo: HRGN

Controle la región descubierta por el proceso de desplazamiento. ScrollDC define esta región; no es necesariamente un rectángulo.

[out] lprcUpdate

Tipo: LPRECT

Puntero a una estructura RECT que recibe las coordenadas del rectángulo que enlaza la región de actualización de desplazamiento. Es el área rectangular más grande que hay que volver a pintar. Cuando se devuelve la función, los valores de la estructura se encuentran en coordenadas de cliente, independientemente del modo de asignación para el contexto de dispositivo especificado. Esto permite a las aplicaciones usar la región de actualización en una llamada a la función InvalidateRgn , si es necesario.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si el parámetro lprcUpdate es NULL, el sistema no calcula el rectángulo de actualización. Si los parámetros hrgnUpdate y lprcUpdate son NULL, el sistema no calcula la región de actualización. Si hrgnUpdate no es NULL, el sistema continúa como si contiene un identificador válido para la región detectada por el proceso de desplazamiento (definido por ScrollDC).

Cuando deba desplazarse por todo el área de cliente de una ventana, use la función ScrollWindowEx .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-misc-l1-5-0 (introducido en Windows 10, versión 10.0.10240)

Consulte también

InvalidateRgn

Otros recursos

RECT

Referencia

ScrollWindowEx