设置控件值 (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)