Compartilhar via


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

InvalidateRgn

Outros recursos

RECT

Referência

Scrollwindowex