Definir o valor de um controle (ui_element.set_value)

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

Declaração

estado, informacoes_ou_erro = ui_element.set_value(seletor_ou_elemento, valor [, 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 }.
• valor Texto, inteiro, número real ou booleano; valor a ser definido no controle.
• opcoes Tabela opcional; consulte Descrição das opções comuns.

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

Esta interface é adequada para controles que aceitam a definição direta de um valor. Para controles deslizantes, tente passar um número real entre 0.0 ~ 1.0 ou um texto percentual como "50%". Se o controle de destino não mudar de fato, pode retornar nil, "value unchanged".

Exemplo

local ui_element = require("ui_element")

ui_element.set_value({
    role = "slider",
    index = 1,
}, 0.5)