設定控制項值 (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)