Установка значения элемента (ui_element.set_value)

Функция доступна в версиях после 20260507.

Объявление

состояние, информация_или_ошибка = ui_element.set_value(селектор_или_элемент, значение [, параметры ])

Параметры

• Селектор или элемент
  Таблица: селектор, элемент, возвращённый поиском, или таблица координат { x = абсцисса, y = ордината }.
• Значение
  Строка, целое число, вещественное число или логическое значение; устанавливаемое значение элемента.
• Параметры
  Необязательная таблица; см. описание общих параметров.

Возвращаемое значение

• Состояние
  Логическое значение: при успехе true, при ошибке nil.
• Информация или ошибка
  При успехе таблица с информацией о действии, при ошибке строка с причиной.

Описание

Интерфейс предназначен для элементов, поддерживающих прямую установку значения. Для ползунка можно передать вещественное число от 0.0 ~ 1.0 или процентную строку вроде "50%". Если целевой элемент фактически не изменился, может возвращаться nil, "value unchanged".

Пример

local ui_element = require("ui_element")

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