SapScroll() — MyAthus AthusScript

Define a posição do scroll vertical de uma tabela SAP GUI (GuiTableControl). Permite navegar diretamente para uma linha específica da tabela sem múltiplos PageDown.

Sintaxe

SapScroll(controlId, posicao [, appId])

Parâmetros

Parâmetro	Obrigatório	Descrição
`controlId`	Sim	Identificador do controle GuiTableControl. Formatos: ID completo ou Nome#Tipo. Utilize a janela de configuração do comando no DevStudio para obter os seletores.
`posicao`	Sim	Posição do scroll vertical (índice de linha, 0-based). Define diretamente VerticalScrollbar.Position da tabela.
`appId`	Não	Identificador da instância SAP gerenciada.

Exemplos

AthusScript

// Ir para a linha 0 (topo da tabela):
SapScroll('tbl#GuiTableControl', 0)

// Ir para a linha 50:
SapScroll('tbl#GuiTableControl', 50)

// Com variável na posição:
SapScroll('tbl#GuiTableControl', $linhaAtual)

// Padrão típico: iterar tabela SAP page by page:
int $pos = 0
int $pageSize = 20
While ($pos < $totalLinhas) {
  SapScroll('tbl#GuiTableControl', $pos, 'sap')
  // ... processar linhas visíveis ...
  $pos = $pos + $pageSize
}

Observações

Atualmente suporta apenas GuiTableControl (tabelas ALV clássicas SAP). Para GuiGridView (ALV Grid moderno), use SapSelect() ou SapClick() para navegar. A posição é o índice da primeira linha visível após o scroll.