Método IDCompositionSurface::Scroll (dcomp.h)
Desplaza un área rectangular de una superficie lógica de Microsoft DirectComposition.
Sintaxis
HRESULT Scroll(
[in] const RECT *scrollRect,
[in, optional] const RECT *clipRect,
[in] int offsetX,
[in] int offsetY
);
Parámetros
[in] scrollRect
Área rectangular de la superficie que se va a desplazar, relativa a la esquina superior izquierda de la superficie. Si este parámetro es NULL, se desplaza toda la superficie.
[in, optional] clipRect
ClipRect recorta el destino (scrollRect después del desplazamiento) del desplazamiento. El único contenido de mapa de bits que se desplazará es el que permanece dentro del rectángulo de recorte una vez completado el desplazamiento.
[in] offsetX
Cantidad de desplazamiento horizontal, en píxeles. Use valores positivos para desplazarse hacia la derecha y valores negativos para desplazarse a la izquierda.
[in] offsetY
Cantidad de desplazamiento vertical, en píxeles. Use valores positivos para desplazarse hacia abajo y valores negativos para desplazarse hacia arriba.
Valor devuelto
Si la función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulte Códigos de error de DirectComposition para obtener una lista de códigos de error.
Comentarios
Este método permite que una aplicación blt/copie un sub rectángulo de un objeto de superficie DirectComposition. Esto evita volver a representar el contenido que ya está disponible.
El rectángulo scrollRect debe estar contenido en los límites de la superficie. Si el rectángulo scrollRect sale de los límites de la superficie, se produce un error en este método.
Los bits copiados por la operación de desplazamiento (origen) se definen mediante la intersección de los rectángulos scrollRect y clipRect .
Los bits que se muestran en la pantalla (destino) se definen mediante la intersección del rectángulo de origen de desplazamiento y clipRect.
Solo se puede llamar a las operaciones de desplazamiento antes de llamar a BeginDraw o después de llamar a EndDraw. Las superficies suspendidas o reanudadas no son candidatas para desplazarse porque todavía se están actualizando.
La aplicación es responsable de garantizar que el área desplazable de un idCompositionVirtualSurface se limita a píxeles válidos. El comportamiento de los píxeles no válidos en scrollRect no está definido.
Las áreas sub rectangulares de superficie virtual descartadas por un recorte o una operación de cambio de tamaño no se pueden desplazar aunque el recorte o el cambio de tamaño se apliquen en el mismo lote. El recorte y el cambio de tamaño se aplican inmediatamente.
Requisitos
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | dcomp.h |
| Library | Dcomp.lib |
| Archivo DLL | Dcomp.dll |