Diminuir o valor de um controle (ui_element.decrease)

Esta função está disponível somente a partir da versão 20260507.

Declaração

estado, informacoes_ou_erro = ui_element.decrease(seletor_ou_elemento [, opcoes])

Parâmetros

• seletor_ou_elemento Tabela; pode ser um seletor, um elemento retornado por uma consulta ou uma tabela de coordenadas { x = coordenada_x, y = coordenada_y }.
• opcoes Tabela opcional. Use steps para especificar o parâmetro de passo.

Valores retornados

• estado Booleano; true em caso de sucesso e nil em caso de falha.
• informacoes_ou_erro Informações de ação em formato de tabela em caso de sucesso; motivo da falha em formato de texto em caso de erro.

Descrição

Usada para controles que aceitam ajustes de aumento e redução, como controles deslizantes e seletores. A quantidade reduzida em cada operação é determinada pelo controle de destino. Para obter um controle preciso, faça chamadas em um loop no script Lua e leia os resultados.

Exemplo

local ui_element = require("ui_element")

ui_element.decrease({
    role = "picker",
    index = 1,
}, {
    steps = 2,
})