Função ScrollDC (winuser.h)
A função ScrollDC rola um retângulo de bits horizontal e verticalmente.
Sintaxe
BOOL ScrollDC(
[in] HDC hDC,
[in] int dx,
[in] int dy,
[in] const RECT *lprcScroll,
[in] const RECT *lprcClip,
[in] HRGN hrgnUpdate,
[out] LPRECT lprcUpdate
);
Parâmetros
[in] hDC
Tipo: HDC
Manipule para o contexto do dispositivo que contém os bits a serem rolados.
[in] dx
Tipo: int
Especifica a quantidade, em unidades de dispositivo, da rolagem horizontal. Esse parâmetro deve ser um valor negativo para rolar para a esquerda.
[in] dy
Tipo: int
Especifica a quantidade, em unidades de dispositivo, da rolagem horizontal. Esse parâmetro deve ser um valor negativo para rolar para cima.
[in] lprcScroll
Tipo: const RECT*
Ponteiro para uma estrutura RECT que contém as coordenadas dos bits a serem rolados. Os únicos bits afetados pela operação de rolagem são bits na interseção desse retângulo e do retângulo especificado por lprcClip. Se lprcScroll for NULL, toda a área do cliente será usada.
[in] lprcClip
Tipo: const RECT*
Ponteiro para uma estrutura RECT que contém as coordenadas do retângulo de recorte. Os únicos bits que serão pintados são os bits que permanecem dentro desse retângulo após a conclusão da operação de rolagem. Se lprcClip for NULL, toda a área do cliente será usada.
[in] hrgnUpdate
Tipo: HRGN
Manipule para a região descoberta pelo processo de rolagem. ScrollDC define essa região; não é necessariamente um retângulo.
[out] lprcUpdate
Tipo: LPRECT
Ponteiro para uma estrutura RECT que recebe as coordenadas do retângulo que limita a região de atualização de rolagem. Essa é a maior área retangular que requer repintura. Quando a função retorna, os valores na estrutura estão nas coordenadas do cliente, independentemente do modo de mapeamento para o contexto do dispositivo especificado. Isso permite que os aplicativos usem a região de atualização em uma chamada para a função InvalidateRgn , se necessário.
Retornar valor
Tipo: BOOL
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Se o parâmetro lprcUpdate for NULL, o sistema não calculará o retângulo de atualização. Se os parâmetros hrgnUpdate e lprcUpdate forem NULL, o sistema não calculará a região de atualização. Se hrgnUpdate não for NULL, o sistema continuará como se contivesse um identificador válido para a região descoberta pelo processo de rolagem (definido por ScrollDC).
Quando você precisar rolar toda a área do cliente de uma janela, use a função ScrollWindowEx .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-misc-l1-5-0 (introduzido no Windows 10, versão 10.0.10240) |
Confira também
Outros recursos
Referência