Chuyển tới nội dung chính

Đặt giá trị điều khiển (ui_element.set_value)

Hàm này khả dụng trong các phiên bản sau 20260507

Khai báo​

trạng thái, thông tin hoặc thông báo lỗi = ui_element.set_value(bộ chọn hoặc phần tử, giá trị [, tùy chọn ])

Tham số​

  • bộ chọn hoặc phần tử
    Bảng. Một bộ chọn, phần tử do truy vấn trả về hoặc bảng tọa độ { x = X, y = Y }.
  • giá trị
    Chuỗi, số nguyên, số hoặc boolean. Giá trị cần đặt cho điều khiển.
  • tùy chọn
    Không bắt buộc, bảng. Xem Tùy chọn chung.

Giá trị trả về​

  • trạng thái
    Boolean. true khi thành công, nil khi thất bại.
  • thông tin hoặc thông báo lỗi
    Bảng khi thành công, chuỗi lý do thất bại khi thất bại.

Mô tả​

Dùng API này cho các điều khiển hỗ trợ đặt giá trị trực tiếp. Với thanh trượt, có thể thử một số từ 0.0 đến 1.0 hoặc chuỗi phần trăm như "50%". Nếu điều khiển đích thực tế không thay đổi, API này có thể trả về nil, "value unchanged".

Ví dụ​

local ui_element = require("ui_element")

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