Đặ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

ok, info_or_err = ui_element.set_value(selector_or_element, value [, options ])

Tham số

• selector_or_element 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 }.
• value Chuỗi, số nguyên, số hoặc boolean. Giá trị cần đặt cho điều khiển.
• options Không bắt buộc, bảng. Xem Tùy chọn chung.

Giá trị trả về

• ok Boolean. true khi thành công, nil khi thất bại.
• info_or_err 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)