Evento de rolagem

Ocorre quando a caixa de rolagem é reposicionada.

Sintaxe

Para ScrollBar: Subobjeto privado _Scroll( )

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

Para Quadro: Subobjeto privado _Scroll(ActionXAs fmScrollAction, ActionYAs fmScrollAction, ByValRequestDxAs Single, ByValRequestDyAs Single, ByValActualDxAs MSForms.ReturnSingle, ByValActualDyAs MSForms.ReturnSingle)

A sintaxe do 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 um 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 mova na direção horizontal.
RequestDy Obrigatório. A distância, em pontos, que você deseja que a barra de rolagem 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 para ActionX e ActionY são:

Constant Valor Descrição
fmScrollActionNoChange 0 Nenhuma alteração ocorreu.
fmScrollActionLineUp 1 Uma pequena distância em cima 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 para a esquerda no teclado para mover a barra de rolagem.
fmScrollActionLineDown 2 Uma pequena distância abaixo 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 acima em uma barra de rolagem vertical; uma página para a 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 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 movimento dependem de qual propriedade foi alterada e do novo valor da propriedade.
fmScrollActionControlRequest 9 Um controle pediu ao contêiner para rolar. A quantidade de movimento depende do controle específico e do contêiner envolvido.
fmScrollActionFocusRequest 10 O usuário foi movido para um controle diferente. A quantidade de movimento depende do posicionamento do controle selecionado e geralmente tem o efeito de mover o controle selecionado para que fique completamente visível para o usuário.

Comentários

Os eventos de rolagem associados a um formulário, quadro ou página retornam os seguintes argumentos: ActionX, ActionY, ActualX e ActualY. O ActionX e o ActionY identificam a ação que ocorreu. ActualX e ActualY identificam a distância percorrida pela caixa de rolagem.

A ação padrão é calcular a nova posição da caixa de rolagem e rolar até 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 à ScrollBar independente 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 que não sejam a 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.