Saltar al contenido principal

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)