ScrollWindow

A ScrollWindow função rola o conteúdo da área de cliente da janela especificada. A ScrollWindow função existe para compatibilidade com versões anteriores. Novos aplicativos devem usar o ScrollWindowEx função.

(BOOL ScrollWindow HWND  hWnd, / / identificador para janela para rolarintXAmount, / / quantidade de horizontal de rolagemintYAmount, / / quantidade de vertical rolagem CONST RECT* lpRect,  / / endereço da estrutura com o Retangular de rolagemCONST RECT* lpClipRect / / endereço da estrutura com o retângulo de clipe);
 

Parâmetros

hWnd

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

XAmount

Especifica a quantidade, em unidades dispositivo, de rolagem horizontal. Se a janela está sendo rolada tem o estilo de CS_OWNDC ou CS_CLASSDC, esse parâmetro usa unidades lógicas em vez de unidades de dispositivo. Este parâmetro deve ser um valor negativo para rolar o conteúdo da janela para a esquerda.

YAmount

Especifica a quantidade, em unidades dispositivo, de rolagem vertical. Se a janela está sendo rolada tem o estilo de CS_OWNDC ou CS_CLASSDC, esse parâmetro usa unidades lógicas em vez de unidades de dispositivo. Este parâmetro deve ser um valor negativo para rolar o conteúdo da janela de backup.

lpRect

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.

lpClipRect

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.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Se o cursor estiver na janela que está sendo rolada, ScrollWindow automaticamente oculta o acento circunflexo para impedi-lo de ser apagado e, em seguida, restaura o cursor após a rolagem. A posição acento circunflexo é adaptada em conformidade.

A área descoberta pela ScrollWindow não for redesenhada, mas é combinado na região de atualização da janela. Eventualmente, o aplicativo recebe uma WM_PAINT mensagem, notificando que a região deve ser redesenhada. Para redesenhar a área descoberta ao mesmo tempo que a rolagem está em ação, chamar o UpdateWindow função imediatamente após chamar ScrollWindow.

Se o parâmetro lpRect é NULL, as posições de qualquer filho windows na janela são compensadas pela quantidade especificada pelos parâmetros XAmount e YAmount ; inválido (não pintadas) áreas da janela também são compensadas. ScrollWindow é mais rápido quando lpRect é NULL.

Se lpRect não for NULL, as posições das janelas filho não são alteradas e áreas inválidas na janela não são compensadas. Para impedir a actualização problemas quando lpRect não for NULL, chamar UpdateWindow para redesenhar a janela antes de chamar ScrollWindow.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
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 funções, RECT, ScrollDC, ScrollWindowEx, UpdateWindow

Index