Scroll() — MyAthus AthusScript

Define a posição de rolagem (scroll) de um controle Win32 com barra de rolagem nativa, como listas, grids e painéis.

Funções relacionadas: GetScrollMin, GetScrollMax, GetScrollPage e GetScrollPosition.

Sintaxe

Scroll(identificador, orientacao, posicao [, appId])

Parâmetros

Parâmetro	Obrigatório	Descrição
`identificador`	Sim	Identificador do controle. Utilize a janela de configuração do comando para obter o identificador dos controles.
`orientacao`	Sim	Vertical, Horizontal.
`posicao`	Sim	Posição de scroll a definir. O intervalo depende do controle — normalmente 0 = início, 100 = fim, ou o número absoluto de pixels/linhas.
`appId`	Não	Identificador da aplicação gerenciada.

Exemplos

AthusScript

// Abrir o notepad
Run('notepad')

// Fixar o tamanho da janela - Ajuste o idioma do sistema
WindowSize('Untitled - Notepad', 800, 300)

// Acelerar o input
Config(Delay, 0)

// Abrir 50 linhas
int $i = 1
While ($i <= 50) {
  Text($i)
  Keys(Press, 'Enter')
  $i++
}

Config(Delay, 1000)

// Rolar para o início
Scroll('Document_0#TextEditor', Vertical, 0)

// Rolar até a linha 20
Scroll('Document_0#TextEditor', Vertical, 20)

Observações

O comando Scroll() é utilizado somente com controles padrão Win32 com rolagem nativa, como o editor do Notepad. Algumas aplicações utilizam frameworks e modelos de rolagem que não são suportadas pelo Scroll(), necessitando outras abordagens - através de teclas ou cliques de mouse.