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

Lấy phần tử giao diện tại một vị trí (ui_element.text_element_at_position)

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

Khai báo​

element, err = ui_element.text_element_at_position(x, y [, pid_or_options ])

Tham số​

  • x, y Số nguyên. Tọa độ màn hình tính bằng pixel vật lý.
  • pid_or_options 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ề​

  • element Bảng. Phần tử giao diện tại tọa độ. nil khi thất bại.
  • err Chuỗi. Lý do thất bại.

Mô tả​

Dùng API này khi đã biết một điểm và muốn đọc phần tử giao diện tại đó, chẳng hạn sau khi nhận dạng hình ảnh hoặc OCR. Đây không phải API nhấn theo tọa độ. Với thao tác nhấn theo tọa độ cố định, hãy dùng touch.tap. API có thể thất bại khi điểm đó trống hoặc màn hình đích không cung cấp phần tử có thể đọc tại đó.

Ví dụ​

local ui_element = require("ui_element")

local item, err = ui_element.text_element_at_position(300, 500, {
    include_hit_state = true,
    max_level = 1,
})

if item then
    nLog(item.text or item.value or "")
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.