Pressionar um botão do mouse de hardware (:down)

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

Declaração

status, mensagem_de_erro = objeto_do_mouse:down(botao)

Parâmetro

• botão Inteiro ou texto: pode receber 1 ~ 32 ou um nome de botão da tabela abaixo; não há distinção entre maiúsculas e minúsculas

Valores de retorno

• status Booleano: retorna true quando o pressionamento é bem-sucedido e false quando falha
• mensagem de erro Texto: motivo da falha do pressionamento

Descrição

Os números dos botões vão de 1 a 32; valores fora desse intervalo são lançados como erros de parâmetro Lua.

Nome	Número
left	1
right	2
middle	3
back	4
forward	5

Os números 1, 2 e 3 normalmente correspondem aos botões esquerdo, direito e do meio; back e forward são aliases dos números 4 e 5. Os números 6 ~ 32 não têm nomes fixos, e o comportamento depende do iOS e do app de destino. Alguns apps podem receber somente os cinco primeiros botões.

Exemplo

local m = assert(mouse.connect())
assert(m:down("left"))
assert(m:up("left"))
assert(m:down(13))
assert(m:up(13))
assert(m:disconnect())