본문으로 건너뛰기

좌표에 있는 UI 요소 가져오기 (ui_element.text_element_at_position)

이 함수는 20260507 이후 버전에서 사용할 수 있습니다.

선언​

요소, 오류 정보 = ui_element.text_element_at_position(가로 좌표, 세로 좌표 [, 프로세스 ID 또는 옵션 ])

매개변수​

  • 가로 좌표, 세로 좌표 정수. 물리 픽셀 단위의 화면 좌표입니다.
  • 프로세스 ID 또는 옵션 정수 또는 테이블, 선택 사항. 정수는 대상 App의 프로세스 ID를 나타내며 테이블은 공통 옵션 설명을 참조하십시오.

반환값​

  • 요소 테이블. 해당 좌표에서 히트한 UI 요소이며 실패하면 nil입니다.
  • 오류 정보 문자열. 실패 원인입니다.

설명​

이 인터페이스는 좌표점을 이미 알고 있을 때 UI 요소를 역조회하는 데 적합합니다. 예를 들어 이미지 인식이나 OCR 결과를 바탕으로 주변 컨트롤을 파악할 수 있습니다. 좌표 클릭 인터페이스가 아닙니다. 고정 좌표 클릭에는 touch.tap을 사용하십시오. 해당 좌표가 빈 영역이거나 대상 화면에서 읽을 수 있는 요소를 제공하지 않으면 실패할 수 있습니다.

예제​

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

참고: 위 코드에서는 이 장에서 설명하지 않는 함수인 nLog, sys.toast를 사용합니다.