텍스트 요소 목록 가져오기 (ui_element.list_text_elements)

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

선언

요소 목록, 오류 정보 = ui_element.list_text_elements([ 프로세스 ID 또는 옵션 ])

매개변수

• 프로세스 ID 또는 옵션 정수 또는 테이블, 선택 사항. 정수는 대상 App의 프로세스 ID를 나타내며 테이블은 공통 옵션 설명을 참조하십시오.

반환값

• 요소 목록 테이블. UI 요소 배열이며 실패하면 nil입니다.
• 오류 정보 문자열. 실패 원인입니다.

설명

현재 대상 App의 텍스트 요소 목록을 가져옵니다. 반환된 요소의 좌표 필드는 물리 픽셀 단위입니다. 이 인터페이스는 이전 스크립트와의 호환성을 위해 유지되며 기본 조회 전략이 비교적 보수적입니다. 새 스크립트에서 요소의 위치를 찾아야 하면 find 또는 snapshot을 우선 고려하십시오.

예제

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

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