Перейти к основному содержимому

Установка значения элемента (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)