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

Liệt kê phần tử văn bản (ui_element.list_text_elements)

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

Khai báo​

danh sách phần tử, thông báo lỗi = ui_element.list_text_elements([ mã tiến trình hoặc tùy chọn ])

Tham số​

  • mã tiến trình hoặc tùy chọn
    Không bắt buộc, số nguyên hoặc bảng. Số nguyên là mã định danh tiến trình của ứng dụng đích; các tùy chọn bảng được mô tả trong Tùy chọn chung.

Giá trị trả về​

  • danh sách phần tử
    Bảng. Mảng phần tử giao diện. nil khi thất bại.
  • thông báo lỗi
    Chuỗi. Lý do thất bại.

Mô tả​

Lấy các phần tử văn bản từ ứng dụng đích hiện tại. Các trường tọa độ trong phần tử trả về dùng pixel vật lý. API này được giữ lại cho kịch bản cũ và dùng các giá trị mặc định thận trọng. Với logic chọn mục tiêu mới, nên dùng find hoặc snapshot.

Ví dụ​

local ui_element = require("ui_element")

local list, err = ui_element.list_text_elements({
    max_level = 1,
    include_hit_state = true,
})

if list then
    for _, item in ipairs(list) do
        if item.text then
            nLog(item.text)
        end
    end
else
    sys.toast(err)
end

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