int ScrollWindowEx ( int dx, int dy, LPCRECT lpRectScroll, LPCRECT lpRectClip, CRgn * prgnUpdate, LPRECT lpRectUpdate, UINT banderas );
Valor devuelto
El valor devuelto es SIMPLEREGION (región invalidado rectangular), COMPLEXREGION (región invalidado no rectangular; rectángulos superpuestos) o NULLREGION (ninguna región invalidada), si la función es correcta; de lo contrario el valor devuelto es ERROR.
Parámetros
dx
Especifica la cantidad en unidades de dispositivo de desplazamiento horizontal. Este parámetro debe tener un valor negativo para desplazarse a la izquierda.
dy
Especifica la cantidad en unidades de dispositivo de desplazamiento vertical. Este parámetro debe tener un valor negativo para desplazarse hacia arriba.
lpRectScroll
Puntos a una estructura RECT que especifica la parte del área de cliente a ser desplazado. Si este parámetro es NULL, se desplaza toda el área cliente.
lpRectClip
Puntos a una estructura RECT que especifica el rectángulo de recorte para desplazarse. Esta estructura tiene precedencia sobre el rectángulo apuntado por lpRectScroll. Sólo bits dentro de este rectángulo se desplazan. Bits de fuera de este rectángulo no se ven afectados, incluso si están en el rectángulo de lpRectScroll . Si este parámetro es NULL, no se lleva a cabo ningún recorte en el rectángulo de desplazamiento.
prgnUpdate
Identifica la región que se ha modificado para celebrar la región invalidada por desplazamiento. Este parámetro puede ser NULL.
lpRectUpdate
Puntos a una estructura RECT que recibirán los límites del rectángulo invalidadas por desplazamiento. Este parámetro puede ser NULL.
banderas
Puede tener uno de los siguientes valores:
Observaciones
Desplaza el contenido del área de cliente de una ventana. Esta función es similar a la ScrollWindow función, con algunas características adicionales.
If SW_INVALIDATE and SW_ERASE are not specified, the ScrollWindowEx member function does not invalidate the area that is scrolled away from. If either of these flags is set, ScrollWindowEx invalidates this area. The area is not updated until the application calls the UpdateWindow member function, calls the RedrawWindow member function (specifying RDW_UPDATENOW or RDW_ERASENOW), or retrieves the WM_PAINT message from the application queue.
Si la ventana tiene el WS_CLIPCHILDREN estilo, las áreas devueltas especificadas por prgnUpdate y lpRectUpdate representan el área total de la ventana deslizante que debe ser actualizado, incluyendo las áreas de ventanas secundarias que es necesario actualizar.
Si el SW_SCROLLCHILDREN bandera es especificado, Windows correctamente no actualizará la pantalla si es desplazado parte de una ventana secundaria. La parte de la ventana deslizante de niño que se encuentra fuera del rectángulo de origen no se borrarán y no va ser dibujar correctamente en su nuevo destino. Uso del DeferWindowPos función de Windows a windows de niño de movimiento que no se encuentren completamente dentro del rectángulo de lpRectScroll . El cursor se recolocan si se establece el indicador SW_SCROLLCHILDREN y el rectángulo de intercalación se cruza con el rectángulo de desplazamiento.
Todas las coordenadas de entrada y salidas (para lpRectScroll, lpRectClip, lpRectUpdatey prgnUpdate) se suponen que en coordenadas de cliente, independientemente de si la ventana tiene el estilo de clase CS_OWNDC o CS_CLASSDC . Uso del LPtoDP y funciones de Windows DPtoLP para convertir a y desde las coordenadas lógicas, si es necesario.
Visión General de CWnd |nbsp; Miembros de clase | Diagrama de jerarquía
Vea tambiénnbsp;CWnd::RedrawWindow, CDC::ScrollDC, CWnd::ScrollWindow, CWnd::UpdateWindow, :: DeferWindowPos, :: ScrollWindowEx