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

Lấy ảnh chụp nhanh giao diện (ui_element.snapshot)

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

Khai báo​

ảnh chụp nhanh, thông báo lỗi = ui_element.snapshot([ tùy chọn ])

Tham số​

Giá trị trả về​

  • ảnh chụp nhanh
    Bảng. Danh sách phần tử giao diện hiện tại kèm các phương thức của ảnh chụp nhanh. nil khi thất bại.
  • thông báo lỗi
    Chuỗi. Lý do thất bại.

Phương thức của ảnh chụp nhanh​

phần tử = ảnh chụp nhanh:find(bộ chọn)
danh sách phần tử = ảnh chụp nhanh:find_all(bộ chọn)
trạng thái, thông tin = ảnh chụp nhanh:click(bộ chọn hoặc phần tử [, tùy chọn ])
trạng thái, thông tin = ảnh chụp nhanh:scroll([ bộ chọn hoặc phần tử, ] hướng [, tùy chọn ])
trạng thái, thông tin = ảnh chụp nhanh:input_text(bộ chọn hoặc phần tử, văn bản [, tùy chọn ])
trạng thái, thông tin = ảnh chụp nhanh:set_text(bộ chọn hoặc phần tử, văn bản [, tùy chọn ])
trạng thái, thông tin = ảnh chụp nhanh:clear_text(bộ chọn hoặc phần tử [, tùy chọn ])
trạng thái, thông tin = ảnh chụp nhanh:toggle(bộ chọn hoặc phần tử [, tùy chọn ])
trạng thái, thông tin = ảnh chụp nhanh:set_checked(bộ chọn hoặc phần tử, trạng thái đánh dấu [, tùy chọn ])
trạng thái, thông tin = ảnh chụp nhanh:set_value(bộ chọn hoặc phần tử, giá trị [, tùy chọn ])
trạng thái, thông tin = ảnh chụp nhanh:increase(bộ chọn hoặc phần tử [, tùy chọn ])
trạng thái, thông tin = ảnh chụp nhanh:decrease(bộ chọn hoặc phần tử [, tùy chọn ])

Mô tả​

Ảnh chụp nhanh là kết quả tại một thời điểm, hữu ích cho việc tra cứu lặp lại hoặc thực hiện liên tiếp các thao tác trên cùng màn hình. Sau khi điều hướng, hiển thị cửa sổ bật lên, cuộn hoặc làm mới nội dung, hãy gọi lại snapshot(). Các trường thường gặp của ảnh chụp nhanh gồm elements và count.

Ví dụ​

local ui_element = require("ui_element")

local ui, err = ui_element.snapshot({
    max_level = 2,
})

if ui then
    local search = ui:find({
        title = "Tìm kiếm",
        role = "text_field",
    })
    if search then
        ui:set_text(search, "XXTouch")
    end
else
    sys.toast(err)
end

Lưu ý: Ví dụ dùng API ngoài chương này là sys.toast.