Compartilhar via

Evento Scroll

  • Artigo

Ocorre quando a caixa de rolagem é reposicionada.

Sintaxe

Para ScrollBar: objetoSub privado _Scroll( )

Para MultiPage: ObjetoSub Privado _Scroll(indexAs Long, ActionXAs fmScrollAction, ActionYAs fmScrollAction, ByValRequestDxAs Single, ByValRequestDyAs Single, ByValActualDxAs MSForms.ReturnSingle, ByValActualDyAs MSForms.ReturnSingle)

For Frame: Private Subobject _Scroll(ActionXAs fmScrollAction, ActionYAs fmScrollAction, ByValRequestDxAs Single, ByValRequestDyAs Single, ByValActualDxAs MSForms.ReturnSingle, ByValActualDyAs MSForms.ReturnSingle)

A sintaxe de evento Scroll tem estas partes:

Sair Descrição
objeto Obrigatório. Um nome de objeto válido.
índice Obrigatório. O índice da página em uma MultiPage associado a esse evento.
ActionX Obrigatório. A ação que ocorreu na direção horizontal.
ActionY Obrigatório. A ação que ocorreu na direção vertical.
RequestDx Obrigatório. A distância, em pontos, que você deseja que a barra de rolagem se mova na direção horizontal.
RequestDy Obrigatório. A distância, em pontos, que você deseja que a barra de rolagem se mova na direção vertical.
ActualDx Obrigatório. A distância, em pontos, que a barra de rolagem percorreu na direção horizontal.
ActualDy Obrigatório. A distância, em pontos, que a barra de rolagem percorreu na direção vertical.

Configurações

As configurações do ActionX e do ActionY são:

Constant Valor Descrição
fmScrollActionNoChange 0 Nenhuma alteração ocorreu.
fmScrollActionLineUp 1 Uma pequena distância em uma barra de rolagem vertical; uma pequena distância à esquerda em uma barra de rolagem horizontal. O movimento é equivalente a pressionar as teclas de seta para cima ou esquerda no teclado para mover a barra de rolagem.
fmScrollActionLineDown 2 Uma pequena distância para baixo em uma barra de rolagem vertical; uma pequena distância à direita em uma barra de rolagem horizontal. O movimento é equivalente a pressionar as teclas de seta para baixo ou para a direita no teclado para mover a barra de rolagem.
fmScrollActionPageUp 3 Uma página em uma barra de rolagem vertical; uma página à esquerda em uma barra de rolagem horizontal. O movimento equivale a pressionar PAGE UP no teclado para mover a barra de rolagem.
fmScrollActionPageDown 4 Uma página para baixo em uma barra de rolagem vertical; uma página à direita em uma barra de rolagem horizontal. O movimento equivale a pressionar PAGE DOWN no teclado para mover a barra de rolagem.
fmScrollActionBegin 5 A parte superior de uma barra de rolagem vertical; a extremidade esquerda de uma barra de rolagem horizontal.
fmScrollActionEnd 6 A parte inferior de uma barra de rolagem vertical; a extremidade direita de uma barra de rolagem horizontal.
fmScrollActionPropertyChange 8 O valor da propriedade ScrollTop ou ScrollLeft foi alterado. A direção e a quantidade de movimentação dependem de qual propriedade foi alterada e do novo valor da propriedade.
fmScrollActionControlRequest 9 Um controle pediu que o contêiner rolasse. A quantidade de movimentação depende do controle e do contêiner específicos envolvidos.
fmScrollActionFocusRequest 10 O usuário mudou para um controle diferente. A quantidade de movimentação depende do posicionamento do controle selecionado e geralmente tem o efeito de mover o controle selecionado para que ele fique completamente visível para o usuário.

Comentários

Os eventos Scroll associados a um formulário, Quadro ou Página retornam os seguintes argumentos: ActionX, ActionY, ActualX e ActualY. ActionX e ActionY identificam a ação que ocorreu. ActualX e ActualY identificam a distância que a caixa de rolagem percorreu.

A ação padrão é calcular a nova posição da caixa de rolagem e, em seguida, rolar para essa posição.

Você pode iniciar um evento Scroll emitindo um método Scroll para um formulário, Quadro ou Página. Os usuários podem gerar eventos de rolagem movendo a caixa de rolagem.

O evento Scroll associado à Barra de Rolagem autônoma indica que o usuário moveu a caixa de rolagem em qualquer direção. Esse evento não é iniciado quando o valor da Barra de Rolagem é alterado por código ou pelo usuário clicando em partes da Barra de Rolagem diferentes da caixa de rolagem.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.