Pular para o conteúdo principal

Rolar a roda do mouse de hardware (:scroll)

Este método está disponível somente a partir da versão 20260805.

Declaração

status, mensagem_de_erro = objeto_do_mouse:scroll(quantidade_de_rolagem_horizontal, quantidade_de_rolagem_vertical)

Parâmetros

  • quantidade de rolagem horizontal Inteiro: quantidade de passos de rolagem, no intervalo [-127, 127]; positivo rola para a direita
  • quantidade de rolagem vertical Inteiro: quantidade de passos de rolagem, no intervalo [-127, 127]; positivo rola para cima

Valores de retorno

  • status Booleano: retorna true quando a rolagem é bem-sucedida e false quando falha
  • mensagem de erro Texto: motivo da falha da rolagem

Descrição

A quantidade de rolagem não é um valor em pixels; o sistema e o app podem dimensionar a distância real conforme suas próprias configurações. Valores fora do intervalo são lançados como erros de parâmetro Lua.

Exemplo

local m = assert(mouse.connect())
assert(m:scroll(0, 10))
assert(m:disconnect())