ScrollDC

A ScrollDC função rola um retângulo de bits horizontalmente e verticalmente.

(BOOL ScrollDC HDC  hDC, / / identificador de contexto de dispositivo deint dx, / / horizontal enrolar unidadesint dy, / / vertical rolagem unidadesCONST RECT* lprcScroll,  / / endereço da estrutura para o Retangular de rolagemCONST RECT* lprcClip,  / / endereço da estrutura para o Retangular de recorteHRGNhrgnUpdate, / / identificador para a região de rolagemLPRECTlprcUpdate / / endereço da estrutura para o retângulo atualização);
 

Parâmetros

hDC

Identificador para o contexto de dispositivo que contém os bits a 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.

lprcScroll

Ponteiro para o estrutura RECT que contém as coordenadas do retângulo de rolagem.

lprcClip

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 descoberta, o processo de rolagem. ScrollDC define esta região; não é necessariamente um retângulo.

lprcUpdate

Ponteiro para o RECT estrutura que recebe as coordenadas do Retangular delimitadora a região de atualizar a rolagem. Esta é a maior área retangular que requer o redesenho. Quando a função retorna, os valores de estrutura são no cliente coordenadas, independentemente do modo de mapeamento para o contexto de dispositivo especificado. Isso permite que aplicativos usar a região de atualizar em um chamar para o função InvalidateRgn , se necessário.

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 parâmetro lprcUpdate é NULL, o sistema não calcular o retângulo atualização. Se ambos os o hrgnUpdate e lprcUpdate os parâmetros são NULL, o sistema não calcula a região de atualizar. Se hrgnUpdate não é NULL, o sistema continuará como se ele contém um válido identificador para a região descoberta, o processo de rolagem (definido por ScrollDC).

Quando você deve rolar a área cliente inteira de uma janela, use o ScrollWindowEx função.

Windows CE: 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 funções, InvalidateRgn, RECT, ScrollWindowEx

Index