Partilhar via


CWnd::ScrollWindow

Rola o conteúdo da área cliente do objeto atual de CWnd .

void ScrollWindow(
   int xAmount,
   int yAmount,
   LPCRECT lpRect = NULL,
   LPCRECT lpClipRect = NULL 
);

Parâmetros

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

  • yAmount
    Especifica a quantidade, em unidades de dispositivo, de rolagem vertical.Este parâmetro deve ser um valor negativo a rolagem anterior.

  • lpRect
    Aponta para um objeto de CRect ou a estrutura de RECT que especifica a parte da área do cliente seja rolada.Se lpRect é NULO, toda a área cliente é rolada.O acento circunflexo está reposicionado se o retângulo do cursor cruza o retângulo de rolagem.

  • lpClipRect
    Os pontos a CRect objeto ou a estrutura de RECT que especificam o retângulo de identificação de rolagem.Somente os bits dentro do retângulo são rolados.Os bits fora de esse retângulo não são afetados mesmo se eles estão no retângulo de lpRect .Se lpClipRect é NULO, nenhum recorte é executado no retângulo de rolagem.

Comentários

Se o acento circunflexo em CWnd está sendo rolado, ScrollWindow oculta automaticamente o acento circunflexo para impedir que é apagado e restaurar o acento circunflexo após a rolagem é concluído.A posição caret é definida de acordo.

A área descoberta pela função de membro de ScrollWindow não é repintada mas é combinada na região atual de atualização do objeto de CWnd .Eventualmente o aplicativo receberá uma mensagem de WM_PAINT que notifica o que a região precisa redesenhar.Para redesenhar a área descoberta ao mesmo tempo que rolagem é feito, chama a função de membro de UpdateWindow imediatamente depois de chamar ScrollWindow.

Se lpRect é NULO, as posições de todas as janelas filho na janela são deslocadas pela quantidade especificada por xAmount e por yAmount, e as áreas inválidos (unpainted) em CWnd também são deslocadas.ScrollWindow é mais rápido quando lpRect é NULO.

Se lpRect não é NULO, as posições das janelas filho não são alterados, e as áreas inválidos em CWnd não são deslocadas.Para evitar problemas quando atualizar lpRect não é NULO, chame a função de membro de UpdateWindow para redesenhar CWnd antes de chamar ScrollWindow.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico de hierarquia

CWnd::UpdateWindow

ScrollWindow