Compartilhar 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 da hierarquia

CWnd::UpdateWindow

ScrollWindow