int ScrollWindowEx ( int dx, int dy, Operador LPCRECT lpRectScroll, Operador LPCRECT lpRectClip, CRgn * prgnUpdate, LPRECT lpRectUpdate, UINT sinalizadores );
Valor de retorno
O valor de retorno é SIMPLEREGION (região Retangular invalidado), COMPLEXREGION (não retangular região inválida; sobreposição retângulos) ou NULLREGION (nenhuma região invalidada), se a função for bem-sucedida; caso contrário, o valor de retorno é erro.
Parâmetros
dx
Especifica a quantidade, em unidades dispositivo, de rolagem horizontal. Esse parâmetro deve ter um valor negativo para rolar para a esquerda.
dy
Especifica a quantidade, em unidades dispositivo, de rolagem vertical. Esse parâmetro deve ter um valor negativo para rolar para cima.
lpRectScroll
Aponta para um RECT estrutura que especifica a parte da área de cliente para ser rolada. Se este parâmetro for NULL, a área cliente inteiro é rolada.
lpRectClip
Aponta para um RECT estrutura que especifica o Retangular de recorte para rolar. Essa estrutura tem precedência sobre o Retangular apontado pelo lpRectScroll. Somente os bits dentro esse Retangular são rolados. Bits fora esse Retangular não são afetados mesmo se estiverem no Retangular de lpRectScroll . Se este parâmetro for NULL, nenhum Recorte será executada no Retangular rolagem.
prgnUpdate
Identifica a região que é modificada para manter a região invalidada rolando. Este parâmetro pode ser NULL.
lpRectUpdate
Aponta para uma estrutura RECT que receberá os limites do Retangular invalidados rolando. Este parâmetro pode ser NULL.
sinalizadores
Pode ter um dos seguintes valores:
Observações
Rola o conteúdo da área cliente da janela. Essa função é semelhante a ScrollWindow função, com alguns recursos adicionais.
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.
Se a janela tem o estilo WS_CLIPCHILDREN , as áreas retornados especificadas por prgnUpdate e lpRectUpdate representam a área total da janela scrolled que deve ser atualizada, incluindo todas as áreas em filho windows que precisam de atualização.
Se o sinalizador SW_SCROLLCHILDREN for especificado, Windows não atualizará corretamente a tela se parte de uma janela filho é rolada. A parte da janela filho scrolled que está fora do retângulo de origem não será apagada e não ser redesenhada corretamente em seu novo destino. Uso o DeferWindowPos função do Windows para mover janelas de filho que não mentir completamente dentro do Retangular de lpRectScroll . O cursor é reposicionado se o sinalizador SW_SCROLLCHILDREN for definido e o Retangular de cursor intercepta o Retangular de rolagem.
Todas as coordenadas de entrada e saídas (para lpRectScroll, lpRectClip lpRectUpdatee prgnUpdate) são consideradas nas coordenadas do cliente, independentemente de se a janela tem o estilo classe CS_OWNDC ou CS_CLASSDC . Uso o LPtoDP e DPtoLP Windows funções para converter para e de coordenadas lógicas, se necessário.
|&Nbsp CWnd visão geral ; Membros de classe | Gráfico de hierarquia
Consulte tambémnbsp;CWnd::RedrawWindow, CDC::ScrollDC, CWnd::ScrollWindow, CWnd::UpdateWindow, :: DeferWindowPos, :: ScrollWindowEx