Establecer el valor de un control (ui_element.set_value)

Esta función solo está disponible a partir de las versiones posteriores a 20260507

Declaración

estado, información o información_de_error = ui_element.set_value(selector_o_elemento, valor [, opciones ])

Parámetros

• selector_o_elemento Tipo tabla: puede ser un selector, un elemento devuelto por una consulta o una tabla de coordenadas { x = coordenada_x, y = coordenada_y }.
• valor Tipo texto, entero, real o booleano: valor que se establecerá en el control.
• opciones Parámetro opcional, tipo tabla; consulta la descripción de las opciones comunes.

Valor devuelto

• estado Tipo booleano: true cuando tiene éxito y nil cuando falla.
• información o información de error Tipo tabla de información de acción cuando tiene éxito; tipo texto con la causa del error cuando falla.

Descripción

Esta interfaz es adecuada para controles que admiten establecer el valor directamente. En un control deslizante se puede intentar pasar un real entre 0.0 ~ 1.0, o un texto porcentual como "50%". Si el control objetivo no cambia realmente, puede devolver nil, "value unchanged".

Ejemplo

local ui_element = require("ui_element")

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