ScrollWindowEx

O ScrollWindowEx função rola o conteúdo da área de cliente da janela especificada.

int (ScrollWindowEx HWND  hWnd, / / identificador para janela para rolarint dx, / / quantidade de horizontal de rolagemint dy, / / quantidade de vertical rolagemCONST RECT* prcScroll,  / / endereço da estrutura com o Retangular de rolagemCONST RECT* prcClip,  / / endereço da estrutura com o retângulo de clipeHRGNhrgnUpdate, / / manipular a atualizar regiãoLPRECTprcUpdate, / / endereço da estrutura para o retângulo atualizaçãoUINTsinalizadores / / sinalizadores de rolagem);
 

Parâmetros

hWnd

Identificador para a janela onde a área de cliente deve ser rolado.

dx

Especifica a quantidade, em unidades dispositivo, de rolagem horizontal. Este parâmetro deve ser um valor negativo para rolar para a esquerda.

dy

Especifica a quantidade, em unidades dispositivo, de rolagem vertical. Este parâmetro deve ser um valor negativo para rolar para cima.

prcScroll

Ponteiro para o estrutura RECT especificando a parte da área de cliente para ser rolada. Se este parâmetro é NULL, a área cliente inteiro é rolada.

prcClip

Ponteiro para o RECT estrutura que contém as coordenadas da retângulo de recorte. Apenas dispositivo bits dentro do retângulo de recorte são afetados. Bits de rolada do lado de fora do retângulo no interior são pintadas; bits de rolada de dentro do retângulo para o exterior não são pintadas.

hrgnUpdate

Identificador para a região que é modificada para manter a região invalidada rolando. Este parâmetro pode ser NULL.

prcUpdate

Ponteiro para o RECT estrutura recebendo os limites do Retangular invalidados rolando. Este parâmetro pode ser NULL.

sinalizadores

Especifica os sinalizadores que controlam a rolagem. Este parâmetro pode ser uma dos seguinte valores:

Valor	Significado
SW_ERASE	Apaga a região, enviando uma mensagem WM_ERASEBKGND para a janela quando especificado com o sinalizador SW_INVALIDATE.
SW_INVALIDATE	Invalida a região identificada pelo hrgnUpdate parâmetro após a rolagem.
SW_SCROLLCHILDREN	Rola todas as janelas filho que interceptam o retângulo apontado pelo prcScroll parâmetro. As janelas filho são roladas pelo número de pixels especificado pelo dx e dy parâmetros. O sistema envia uma mensagem WM_MOVE para Tudo as janelas filho que interceptam o retângulo prcScroll , mesmo se eles não se movem.
SW_SMOOTHSCROLL	Windows NT 5.0 e posterior: Rola usar rolagem suave. Use a parte HIWORD do parâmetro de sinalizadores para indicar quanto tempo a operação de rolagem suave deve levar.

Retornar valores

Se a função for bem-sucedido, 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 falhar, o valor de retorno é erro. Para informações de erro estendidas get, chamar GetLastError.

Observações

Se os sinalizadores SW_INVALIDATE e SW_ERASE não forem especificados, ScrollWindowEx não invalida a área que é rolada de. Se qualquer um desses sinalizadores é definido, ScrollWindowEx invalida esta área. A área não será atualizada até que as chamadas aplicativo o UpdateWindow função, chamadas a RedrawWindow funcionar (especificando o sinalizador RDW_UPDATENOWfaz com ou RDW_ERASENOWfaz), ou recupera a mensagem WM_PAINT da fila de aplicativo.

Se a janela tem o estilo WS_CLIPCHILDREN, as áreas retornados especificadas por hrgnUpdate e prcUpdate 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, o sistema não atualiza 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 é apagada e não está corretamente redesenhada no seu novo destino. Para mover janelas filho que não mentir completamente dentro do retângulo especificado pelo prcScroll, use o DeferWindowPos função. 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 prcScroll, prcClip, prcUpdatee hrgnUpdate) são determinadas como coordenadas cliente, regardless of se a janela tem o estilo classe CS_OWNDC ou CS_CLASSDC. Use a LPtoDP e DPtoLP funções para converter para e de coordenadas lógicas, se necessário.

Windows CE: O sinalizadores parâmetro não suporte SW_SCROLLCHILDREN.

Somente um dos parâmetros dx e dy pode ser diferente de zero.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de barras de rolagem, barra de rolagem funciona, DeferWindowPos, DPtoLP, LPtoDP, RECT, RedrawWindow, UpdateWindow

Index